Pepijn,
I could not agree more! I just created CELIX-330, so
we can start adding some documentation.
Regards,
Bjorn
On 15.12.2015 13:47, Pepijn Noltes wrote:
> Hi All,
>
> I would like to discuss the option to document more using markdown files in
> a documents subdir.
>
> Since our git is mirrored on github and github has a nice visualization of
> markdown files, I see an opportunity to document more using markdown files.
> I think documenting this way lowers threshold to create/update
> documentation compared to using the Apache website and CMS tooling.
> Specially for documentations closely related to the code.
>
> IMO we should not move everything to the documents subdir, but more
> documentation like building Celix, hello world bundle example, getting
> started guide, etc. The Apache Celix website can still be used as entry
> point for most documentation, but then forward to github for the actual
> (and hopefully) more update documentation.
>
> Any thoughts/comments ?
>
> Greetings,
> Pepijn
>
