The new KDevelop manual

Jump to: navigation, search

I have started a new thread for this ongoing conversation - the indentation was beginning to be a bit disruptive :-)

I see from your last entry that I have misunderstood what you were doing: I thought you were taking the old KDevelop4 handbook on UserBase as your starting point, but now I gather that you are actually working from a docbook version. This may pose a problem: The translations I copied over were for the KDevelop4 pages on UserBase and may not match up with the texts you got from the docbook.

Technical problems aside we should think about the implications of this: It is not a good idea to have two versions of the manual being developed in parallel - that will almost certainly lead to inconsistencies. Have you taken over responsibility for the KDevelop5 manual? In that case you may decide to develop the manual on UserBase and request, that other contributors do the same. Otherwise it might be better to continue working on the docbook (even though I agree with you that docbook xml is not nice to work with).

There is currently no simple way to convert docbooc to wiki format (the other way is somewhat easier - I have plans to automate both conversions but it is a non-trivial task and not my first priority). Once you decide that UserBase is the way to go I can help you with transferring the pages. But first I think we should check the pages already transferred for inconsistencies between the docbook text and the translated text on UserBase, so that we can mark the translation units that are not up to date.

Claus chr (talk)13:15, 24 September 2017

"I see from your last entry that I have misunderstood what you were doing: I thought you were taking the old KDevelop4 handbook on UserBase as your starting point, but now I gather that you are actually working from a docbook version. This may pose a problem: The translations I copied over were for the KDevelop4 pages on UserBase and may not match up with the texts you got from the docbook. "

-This is not true. In the start we will copy all the manual 4 and move it to manual 5. Some programmers in the chat told me that the docbook that exists at the Git has new updates. My task is to bring those updates to the manual 5 on UserBase, as a second step. Third step is to change only the UserBase to the latest kdevelop5 features not the docbook because we will have only one copy which will be the UserBase.

But first I think we should check the pages already transferred for inconsistencies between the docbook text and the translated text on UserBase, so that we can mark the translation units that are not up to date.

-Yes, we will do that.

Pfollas (talk)11:07, 28 September 2017

Thats I relief :-). In that case we have no problem with the pages already created. Do I understand you correctly, that I can go ahead and transfer the remaining pages from the KDevelop4 wiki pages? If so, I can probably get it done over the weekend.

I guess you were asking if there is an easy way to get pure text out of a docbook? I'm afraid this is not the case.

Claus chr (talk)05:10, 29 September 2017

yes, go ahead and move the remaining pages :) :).

and Yes this is what I was asking. You see my bad english brought this mess. But I believe everything are ok now.

Pfollas (talk)19:54, 29 September 2017

I have now copied the content of all remaining KDevelop4 manual pages to the KDevelop5 manual including translations.

Claus chr (talk)08:43, 1 October 2017

Thank you very much. I will do the second step in the following days.

Pfollas (talk)14:02, 1 October 2017

The second step is done!!!!! I have updated the wiki for kdevelop 5 manual to be the same as the docbook at git. Thanks to this guy <tosky> from kdevelop chat. He showed me the history of the docbook and told which changes I have to make. ( look from 2013 -04-29 https://cgit.kde.org/kdevelop.git/log/doc/kdevelop/index.docbook ). Now We are doing the nice meat! We will update most of the docs there so I can be valid for kdevelop 5.1.2!!!! Step three starts the next days!!!

Pfollas (talk)19:39, 14 October 2017