local copy of exported userbase documentation

[Aleix Pol]

On Fri, Sep 2, 2011 at 7:28 PM, Milian Wolff <mail at milianw.de> wrote:

> Burkhard Lück, 17.08.2011:
> > Hi devels,
> >
> > Yuri Chornoivan has exported the userbase kdevelop manual and converted
> it
> > to docbook, see https://bugs.kde.org/show_bug.cgi?id=27994
> >
> > We'd like to get that into the git repository, where it can be processed
> by
> > scripty and shipped along with the kdevelop package.
> >
> > Any objections?
> >
> > The project has a folder kdevelop/doc, but most of the content seems to
> be
> > obsolete from kdevelop 2 + 3.
> >
> > Where to place the exported userbase documentation?
> >
> > A new folder kdevelop/doc/userdoc or kdevelop/userdoc?
>
> No basic objections, though I agree with Alexander that linking directly to
> userbase would be preferrable if the user has a working network connection.
> I
> just doubt the required infrastructure for that is available right now.
>
> One big open question: Will you guys continue to update/sync the work
> between
> userbase and docbook? Can't you also translate the wiki?
>
> bye
> --
> Milian Wolff
> mail at milianw.de
> http://milianw.de
>
> --
> KDevelop-devel mailing list
> KDevelop-devel at kdevelop.org
> https://barney.cs.uni-potsdam.de/mailman/listinfo/kdevelop-devel
>
>
Well, we have the disadvantage of making it possible to view locally, when
you don't have internet, I'm not sure if that's a use case anymore, though.
And yes, userbase can be translatable, but l10n.kde.org translators can't do
it yet with their usual tools, so it's not that much widespread.

Maybe it would be also interesting to know if it's possible to generate
docbooks from the wikis.

Anyway, that's not what Burkhart asked, I think we should remove all the
kdevelop/doc altogether and use this one as the official right now, since I
don't think there's anyone interested in using whatever can be used from
there.

Aleix
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kdevelop-devel/attachments/20110904/d9bb070a/attachment.html>