Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Need documentation #74

Open
sudz123 opened this issue Oct 10, 2018 · 4 comments
Open

Need documentation #74

sudz123 opened this issue Oct 10, 2018 · 4 comments
Labels
css good first issue Good for newcomers hacktoberfest help wanted Extra attention is needed html

Comments

@sudz123
Copy link
Owner

sudz123 commented Oct 10, 2018

  • Create a new folder in home which will hold the docs website
  • Add examples and create a documentation webpage, with html, css javascript files inside this folder

You can take reference from test.cpp
The site could look like the Eigen documentation here

@sudz123 sudz123 added help wanted Extra attention is needed good first issue Good for newcomers hacktoberfest html css labels Oct 10, 2018
@vinnyA3
Copy link
Contributor

vinnyA3 commented Oct 28, 2018

Can I take this one @sudz123 ? This seems like a really fun project! I want to help with the C++ portion as well, but I need some time to study / prepare before I start pushing any working C++ code.

@sudz123
Copy link
Owner Author

sudz123 commented Oct 28, 2018

Sure @vinnyA3 Go ahead. Take your time. I would say start with the basics first, with descriptions about the simplest algorithms. Work on this over multiple PRs, you can start with submitting one with a basic template html page in a folder in home. With each PR you submit, I can give you feed back and we can do this. Just be sure your code is well commented like Optimizer.h.

@vinnyA3
Copy link
Contributor

vinnyA3 commented Oct 31, 2018

@sudz123 Updates:
I had a working documentation site that I wanted to show you and gather your thoughts on! However, I decided to scrap it :/ I felt the project build infrastructure wasn't the best for the type of project--it was a bit more complex than it had to be; if someone else wanted to contribute, then it might be too difficult to get up and running. In addition, I felt the styles could be architected a bit better (for maximum reusability and maintainability). All being said, I am still going to stick with the same prototype design. I'll deliver soon! Happy hacking :)

@sudz123
Copy link
Owner Author

sudz123 commented Nov 1, 2018

Sure @vinnyA3 , I will trust your decision. Scalability and reusability are of utmost importance in this project. Once you submit a PR, I can comment more on this. All the best, happy hacking :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
css good first issue Good for newcomers hacktoberfest help wanted Extra attention is needed html
Projects
None yet
Development

No branches or pull requests

2 participants