Ranter
Join devRant
Do all the things like
++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatar
Sign Up
Pipeless API
From the creators of devRant, Pipeless lets you power real-time personalized recommendations and activity feeds using a simple API
Learn More
Comments
-
At the first look it looks good indeed - I'll definetly give it a deeper dive into it
-
Why not markdown files in a docs/ folder? Prepare the docs for eventual release to public and also gain experience in writing and formatting docs for stuff like github…
PS: you also get the benefits of git versioning for files, as they are part of the project :)
PS2: no need for extra software and hosting -
Also, write javadoc style comments to autogenerate the class/method/property/return value stuff. When the project grows you might need structured docs
-
@balaianu good call! Thought about that mainly because of no extra software or hosting but I think without something like Github we'll struggle to keep the overview of the MD files - how do you organize them?
@Hakash yeah absolutely! Most of the time a good Java doc comes in handy even in the beginning stage of projects -
@mjoellnier Well, you said private, so you can try something like Bitbucket, that has free private repos. As for organising, just follow the module structure of your code at first...and adjust as your docs grow.
-
@balaianu I think that will be the way we will start to go. Md files should also be pretty good transferable even if we decide to change
@NefixEstrada We'd like to go along without a hosting necessary on our sides - but I will also keep it in mind -
@xalys when our idea turns out to be as awesome as we think it is this will be an option - but as far as I can say right now it's not the right thing for a poor students side project ^^
Related Rants
Do you guys know any tool for documentation in a private side project with two guys?
question
docs
documentation
side project