-
Notifications
You must be signed in to change notification settings - Fork 6
Writing documentation for RIP. #34
Comments
I feel using documentation generators such as Sphinx with documentation guidelines would be a good idea. With a standard documentation guideline we can generate documentation for different versions. This also moves the responsibility of writing the documentation on to the developer who will have the most context about the given feature being added in a PR. Having a documentation checks in the PR process would help ensure that at least, new features being added will be properly documented. |
@bIgBV Can we use ReadTheDocs? They support both Mkdocs and Sphinx among many others. They directly pull from your repo and generate a site that can be hosted at a subdomain. All this, free of cost for open source projects. |
+1 to both @bIgBV and @robinmaben. |
@uttamk we should update the contributing guidelines with the documentation style which we want to enforce. Also, @robinmaben that answers the question I had about where this documentation would be hosted. |
I know that sphinx supports documentation for different versions, but I am not completely certain about how we'll structure the different versions. Will any enhancements being added to RIP henceforth be a different version and we can start documenting existing features ? |
I suppose we will have a minor version for each milestone (that doesn't On Tue, Jan 19, 2016 at 12:24 PM, Bhargav notifications@github.com wrote:
|
I am raising this issue as a platform to discuss the following topics:
If you have any other point to raise, please do so.
The text was updated successfully, but these errors were encountered: