> On Feb. 25, 2014, 11:38 a.m., Luigi Toscano wrote:
> > I'm not sure if it enough: what if fundamentals is not installed? 
> > kde-runtime as we knows is going away. Maybe we should rethink how it works.

So I guess these days fundamentals is shipped along with KHelpCenter.

Even without this patch, we're already linking to Fundamentals in a lot of 
places, see for instance 
http://docs.kde.org/stable/en/applications/kate/settings-menu.html (and various 
other Settings menus around the project do the same thing).

Presumably an application that uses kdoctools for documentation would need to 
require KHelpCenter so its documentation can actually be seen, so that should 
be Good Enough, no?  If not, we need to either revisit how we provide 
documentation for common dialogs like Custom Shortcuts or revisit where to 
stick Fundamentals.  ;-)

As for this patch in particular, I believe Burkhard's rationale for wanting 
this done was that keeping this information in a standard DocBook is easier to 
update and translate, unlike the entities which aren't presently converted to 
pots and have to be translated manually.  So if it's okay to link to 
Fundamentals here it should be a nice improvement.


- T.C.


-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://git.reviewboard.kde.org/r/116038/#review50799
-----------------------------------------------------------


On Feb. 25, 2014, 1:16 a.m., T.C. Hollingsworth wrote:
> 
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://git.reviewboard.kde.org/r/116038/
> -----------------------------------------------------------
> 
> (Updated Feb. 25, 2014, 1:16 a.m.)
> 
> 
> Review request for Documentation, Luigi Toscano and Burkhard L?ck.
> 
> 
> Repository: kdoctools
> 
> 
> Description
> -------
> 
> replace the old &install.*.documentation; and &help.menu.documentation; 
> content with links to Fundamentals.
> 
> One other TODO I noticed while messing around in there.  I know Burkhard's 
> been wanting this for a long time.  ;-)
> 
> 
> Diffs
> -----
> 
>   src/customization/en/entities/help-menu.docbook 1c4da80 
>   src/customization/en/entities/install-compile.docbook 855b0de 
>   src/customization/en/entities/install-intro.docbook 3f6f5ed 
> 
> Diff: https://git.reviewboard.kde.org/r/116038/diff/
> 
> 
> Testing
> -------
> 
> 
> Thanks,
> 
> T.C. Hollingsworth
> 
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: 
<http://mail.kde.org/pipermail/kde-doc-english/attachments/20140916/66b78774/attachment.html>

Reply via email to