<div dir="ltr"><div dir="ltr">On Thu, Jan 15, 2026 at 9:54 AM Albert Astals Cid <<a href="mailto:aacid@kde.org">aacid@kde.org</a>> wrote:</div><div class="gmail_quote gmail_quote_container"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">El dimecres, 14 de gener del 2026, a les 12:34:59 (Hora estàndard d’Europa <br>
central), Luigi Toscano va escriure:<br>
> Benson Muite ha scritto:<br>
> > On Wed, Jan 14, 2026, at 1:42 PM, Johnny Jazeix wrote:<br>
> >> Hi,<br>
> >> <br>
> >> Since we restored <a href="http://docs.kde.org" rel="noreferrer" target="_blank">docs.kde.org</a>, I would like to propose to add a new<br>
> >> item in the checklist [1] for new projects (rewording welcome if<br>
> >> needed):<br>
> >> - [ ] User documentation in docbook format should exist in a doc (or<br>
> >> docs) folder<br>
> > <br>
> > Docbook is nice and can be converted to html for web or viewed<br>
> > directly using desktop applications.  Would authoring in other formats<br>
> > and converting to Docbook also be allowed? For example Sphinx<br>
> > uses ReStructured Text which can be converted to DocBook, TexInfo<br>
> > can also be converted to DocBook.<br>
> <br>
> Right now, the source format used by khelpcenter and <a href="http://docs.kde.org" rel="noreferrer" target="_blank">docs.kde.org</a> is<br>
> docbook. A few bigger manual uses sphinx, (digikam, kdenlive, krita,<br>
> kstars) but that require a specialized site and I would consider that an<br>
> exception and not the rule for now.<br>
> We also generate man pages from docbook, I would definitely rule out<br>
> TexInfo. If/when we manage to pull enough work to support sphinx in<br>
> kdoctools we can consider sphinix as regular, but not right now.<br>
<br>
Any new format for end user documentation needs to also consider how we do <br>
translations. We have that solved for docbook.<br></blockquote><div><br></div><div>Sphinx does have that solved, to a certain extent at least. </div><div>It isn't terribly efficient though so more work is required there - likely a rewrite of how it does things.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
Cheers,<br>
  Albert<br>
<br>
<br>
<br></blockquote><div><br></div><div>Cheers,</div><div>Ben </div></div></div>