[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
|
Re: [udig-devel] doc conversion to Sphinx and RST
|
I'm not sure about the new location. I had something different in my
mind but lets sort it. I would prefer a single source documentation
where the content for the online help (both eclipse and really online
help at udig.refractions.net) could be generated. This in mind we need
a multi-language system (like OSGeo live does) to support
translations.
Single source means also in combination with program code sources
(java, xml, etc). 1+ for udig-platform. Within the repository a root
doc folder would be the entrance fro documentations, independent from
target (user/developer, offline walk-through pdfs/eclipse help for
net.refractions.udig.help/online help at http://udig.refractions.net)
Is it possible to extract user documentation from confluence wiki for
the integrated eclipse help? The wiki has the advantage that potential
non programmers haven not to deal with source checkout and obstacles
like git fetches/pull's/push's. How likes to help in user docs just
need a wiki account, nothing else ..
You see, I'm torn between developer friendly single source system and
be open for contribution from end-users and non developers without any
technical obstacles.
What about you?
Frank
2012/5/11 Jody Garnett <jody.garnett@xxxxxxxxx>:
> With that in mind the correct locations should be:
> - plugins/net.refractions.udig.help (for user docs)
> - extras/net.refractions.udig.dev (for developers guide; although I think we
> could move this to plugins in order to fold it into the maven command line
> build)
