Re: [Freeipa-devel] FreeIPA documentation: getting started & devel docs (FOSDEM takeaways - Software Archaeology for Beginners)

2014-02-25 Thread Nathan Kinder
On 02/25/2014 01:32 AM, Petr Spacek wrote: > Hello list, > > I have seen talk "Software Archaeology for Beginners" from FOSDEM 2014 > [1] and I have couple notes: > > 1) User docs: > Make sure that project's documentation tells its own story: > Documentation is not so useful if it is a bunch of u

[Freeipa-devel] FreeIPA documentation: getting started & devel docs (FOSDEM takeaways - Software Archaeology for Beginners)

2014-02-25 Thread Petr Spacek
Hello list, I have seen talk "Software Archaeology for Beginners" from FOSDEM 2014 [1] and I have couple notes: 1) User docs: Make sure that project's documentation tells its own story: Documentation is not so useful if it is a bunch of unrelated documents. Make sure that there is 'introducti