New developer.gnome.org!

Emmanuele Bassi via gnome-doc-list <[email protected]> Fri, 30 Jul 2021 15:34:46 +0100
Newsgroups gmane.comp.gnome.documentation
Message-ID <CALnHYQER+Vd8NgGg42hd5386hBCcuu2opW4K29AAv+zy6=jk3w@mail.gmail.com>
--===============4248182654093159075==
Content-Type: multipart/alternative; boundary="000000000000a196d105c8581ff7"

--000000000000a196d105c8581ff7
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Hi all;

I've just announced the new version of the developer.gnome.org website:

https://discourse.gnome.org/t/new-gnome-developer-documentation-website/713=
4

On the back end of things: the new website is based on Sphinx, and
published using the GitLab CI. The content is in reStructuredText format.
For more information on both:

 -
https://docs.readthedocs.io/en/stable/intro/getting-started-with-sphinx.htm=
l
 - https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html

The content is available under the documentation team group:

 - https://gitlab.gnome.org/Teams/documentation/developer-www

and you can contribute using the same workflow as any other GitLab
project=E2=80=94including editing in the web UI. You can easily build a ren=
der
locally using the provided `build.sh` script.

The developer-www repository replaces the gnome-devel-docs repo:

  - https://gitlab.gnome.org/GNOME/gnome-devel-docs/

for the following documents:

 - accessibility-devel-guide
 - optimisation-guide
 - programming-guidelines
 - platform-overview

Additionally, the HIG has been moved to its own repository under the design
team group:

 - https://gitlab.gnome.org/Teams/Design/hig-www/

The system administrators guide

The system administrators want to lock down library-web, which will impact
help.gnome.org, so we'll have to figure out how to update the process for
publishing the content on that website.

Ciao,
 Emmanuele.

--=20
https://www.bassi.io
[@] ebassi [@gmail.com]

--000000000000a196d105c8581ff7
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div>Hi all;</div><div><br></div><div>I&#39;ve just announ=
ced the new version of the <a href=3D"http://developer.gnome.org">developer=
.gnome.org</a> website:</div><div><br></div><div><a href=3D"https://discour=
se.gnome.org/t/new-gnome-developer-documentation-website/7134">https://disc=
ourse.gnome.org/t/new-gnome-developer-documentation-website/7134</a></div><=
div><br></div><div>On the back end of things: the new website is based on S=
phinx, and published using the GitLab CI. The content is in reStructuredTex=
t format. For more information on both:</div><div><br></div><div>=C2=A0- <a=
 href=3D"https://docs.readthedocs.io/en/stable/intro/getting-started-with-s=
phinx.html">https://docs.readthedocs.io/en/stable/intro/getting-started-wit=
h-sphinx.html</a></div><div>=C2=A0- <a href=3D"https://www.sphinx-doc.org/e=
n/master/usage/restructuredtext/basics.html">https://www.sphinx-doc.org/en/=
master/usage/restructuredtext/basics.html</a></div><div><br></div><div>The =
content is available under the documentation team group:</div><div><br></di=
v><div>=C2=A0- <a href=3D"https://gitlab.gnome.org/Teams/documentation/deve=
loper-www">https://gitlab.gnome.org/Teams/documentation/developer-www</a></=
div><div><br></div><div>and you can contribute using the same workflow as a=
ny other GitLab project=E2=80=94including editing in the web UI. You can ea=
sily build a render locally using the provided `build.sh` script.</div><div=
><br></div><div>The developer-www repository replaces the gnome-devel-docs =
repo:</div><div><br></div><div>=C2=A0 - <a href=3D"https://gitlab.gnome.org=
/GNOME/gnome-devel-docs/">https://gitlab.gnome.org/GNOME/gnome-devel-docs/<=
/a></div><div><br></div><div>for the following documents:</div><div><br></d=
iv><div>=C2=A0- accessibility-devel-guide</div><div>=C2=A0- optimisation-gu=
ide</div><div>=C2=A0- programming-guidelines</div><div>=C2=A0- platform-ove=
rview</div><div><br></div><div>Additionally, the HIG has been moved to its =
own repository under the design team group:<br></div><div><br></div><div>=
=C2=A0- <a href=3D"https://gitlab.gnome.org/Teams/Design/hig-www/">https://=
gitlab.gnome.org/Teams/Design/hig-www/</a></div><div><br></div><div>The sys=
tem administrators guide<br></div><div><br></div><div>The system administra=
tors want to lock down library-web, which will impact <a href=3D"http://hel=
p.gnome.org">help.gnome.org</a>, so we&#39;ll have to figure out how to upd=
ate the process for publishing the content on that website.<br></div><div><=
br></div><div>Ciao,</div><div>=C2=A0Emmanuele.<br></div><div><br>-- <br><di=
v dir=3D"ltr" class=3D"gmail_signature" data-smartmail=3D"gmail_signature">=
<a href=3D"https://www.bassi.io" target=3D"_blank">https://www.bassi.io</a>=
<br>[@] ebassi [@<a href=3D"http://gmail.com" target=3D"_blank">gmail.com</=
a>]</div></div></div>

--000000000000a196d105c8581ff7--

--===============4248182654093159075==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
gnome-doc-list mailing list
[email protected]
https://mail.gnome.org/mailman/listinfo/gnome-doc-list

--===============4248182654093159075==--