celix-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Bjoern Petri <bjoern.pe...@sundevil.de>
Subject Re: Documentation in github
Date Thu, 17 Dec 2015 20:13:54 GMT



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
> 

Mime
View raw message