New home for KStars user manual

[Paul Brown]

On Sunday, 30 March 2025 17:10:00 Central European Summer Time Jasem Mutlaq 
wrote:
> We should be good to go with the English version ready. We don't have any
> up-to-date manual online now (the last one is quite old and does not
> contain a lot of updated sections) so I say we'd go ahead with the
> announcement. I don't have a mapping of the old docbook to the new RST. I
> think most docbooks were converted to RST while keeping the same file name.

We can qualify the posts to social media with something like

"At the moment only English is available, but more languages coming soon."

Something like:

"""
#KStars debuts a new documentation site!

A comprehensive resource that helps you to get to know and make the most of 
KDE's fantastic night sky observatory and astrophotography utility.

At the moment, only English is available. More languages coming soon.

https://kstars-docs.kde.org
"""

What do you think?

Paul

> 
> --
> Best Regards,
> Jasem Mutlaq
> 
> 
> 
> On Sun, Mar 30, 2025 at 6:04 PM Luigi Toscano <luigi.toscano at tiscali.it>
> 
> wrote:
> > Shouldn't we first solve the problem with importing translations?
> > 
> > Please provide a mapping between the old _source_ docbooks and the new RST
> > pages, so that I can help with reshuffling the po files.
> > 
> > Jasem Mutlaq ha scritto:
> > > Absolutely, no one knows about the new documentation website. We will
> > 
> > also
> > 
> > > need to update our README and KStars website to point to it.
> > > 
> > > 
> > > 
> > > --
> > > Best Regards,
> > > Jasem Mutlaq
> > > 
> > > 
> > > 
> > > On Sun, Mar 30, 2025 at 3:58 PM Paul Brown <paul.brown at kde.org
> > > 
> > > <mailto:paul.brown at kde.org>> wrote:
> > >     On Friday, 28 March 2025 05:44:01 Central European Summer Time Jasem
> > 
> > Mutlaq
> > 
> > >     wrote:
> > >     > Hello all,
> > >     > 
> > >     > Finally after a lot of work, we have a new home for KStars
> > 
> > documentation
> > 
> > >     > written using Sphinx: https://kstars-docs.kde.org/
> > >     > 
> > >     > The translations are not completely done. I hope the translations
> > 
> > teams can
> > 
> > >     > continue to improve the translations from docbook to rst and
> > 
> > submit their
> > 
> > >     > changes here:
> > https://invent.kde.org/documentation/kstars-docs-kde-org
> > 
> > >     > We will be removing the docbook manual from KStars.
> > >     > 
> > >     > --
> > >     > Best Regards,
> > >     > Jasem Mutlaq
> > >     
> > >     Hi Jasem,
> > >     
> > >     Can we promote this on social media?
> > >     
> > >     Cheers
> > >     
> > >     Paul
> > >     --
> > >     Promotion & Communication
> > >     
> > >     www: https://kde.org
> > >     Mastodon: https://floss.social/@kde
> > >     Facebook: https://www.facebook.com/kde/
> > >     LinkedIn: https://www.linkedin.com/company/kde


-- 
Promotion & Communication

www: https://kde.org
Mastodon: https://floss.social/@kde
Facebook: https://www.facebook.com/kde/
LinkedIn: https://www.linkedin.com/company/kde