Skip to content
This repository has been archived by the owner on Jul 24, 2024. It is now read-only.

Add CONTRIBUTING.md to help new contributors get started #32

Merged
merged 1 commit into from
Oct 4, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# Contributing

Any contribution is more the welcomed.

> **Tip:** If you are working from VS Code, you can [install the recommended extensions](https://dev.to/askrishnapravin/recommend-vs-code-extensions-to-your-future-teammates-4gkb) to quickly get setup.

## Working Locally

After forking and cloning your repo, You'll need to install a few dependencies

```sh
sudo apt install libeigen3-dev libgtest-dev libgmock-dev
```

Or you can use your favorite system installed.
If you prefer C++ package managers, you can do

- `vcpkg install eigen3 gtest`
- `conan install --requires="eigen/[>=3 <4]" --requires="gtest/[>=1 <2]" --generator=CMakeDeps --output-folder=build`

### Building the library

```sh
cmake -E make_directory build
cd build

cmake ..
cmake --build .
ctest .
```

If you have any questions feel free to reach out on discord.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ lib/

# IDE-specific files
.vscode/
.vscode/!extensions.json # Allow to provide recommended extensions
.idea/

# Ignore any personal or system-specific files
Expand Down
8 changes: 8 additions & 0 deletions .vscode/extensions.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"recommendations": [
"ms-vscode.cpptools",
"ms-vscode.cpptools-extension-pack",
"ms-vscode.cmake-tools",
"twxs.cmake"
]
}
20 changes: 4 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,24 +91,12 @@ I used Eigen::Map for performing all operations in place without making a single

If you want to learn c++ or about automatic differentiation, feel free to contribute! There is a lot of work to do.

## To build the project

## To build the project:

```sh
mkdir build
cd build
cmake ..
make
sudo make install
```

Eigen supports cmake, so if sombody wants to integrate that support in the CMakeLists.txt would be nice.

Be sure Eigen is installed in your system.
Don't forget to add the path of the installed library when compiling, for example, if you want to compile example.cpp with g++:

```g++ example.cpp -LCaberNet/lib -lCaberNet -I CaberNet/include```
Please see the [contributing](.github/CONTRIBUTING.md#building-the-library) guide for more information.

## Acknowledgements

This project is being possible thanks to:

* @prince-chrismc.