Re: GNOME Documentation Style Guide [was: New developer.gnome.org!]

Emmanuele Bassi via gnome-doc-list <[email protected]> Thu, 12 Aug 2021 19:00:26 +0100
Newsgroups gmane.comp.gnome.documentation
Message-ID <CALnHYQELDYuUWEZqvbGzpCLoUNHi06_w=kktEUrTsXGM+QTtjg@mail.gmail.com>
--===============4974518299960740264==
Content-Type: multipart/alternative; boundary="00000000000025aab005c96083a9"

--00000000000025aab005c96083a9
Content-Type: text/plain; charset="UTF-8"

On Thu, 12 Aug 2021 at 18:25, sajolida <[email protected]> wrote:

> Emmanuele Bassi via gnome-doc-list:
> >
> > I've just announced the new version of the developer.gnome.org
> > <http://developer.gnome.org> website:
>
> Hi, sajolida from Tails here.
>
> Sorry I'm probably very late to the dance but I now see that the former
> GNOME Documentation Style Guide disappeared from the new
> developer.gnome.org:
>
> https://developer.gnome.org/gdp-style-guide/


The guide is still available on the snapshot of the old developers
documentation site:

https://developer-old.gnome.org/gdp-style-guide/stable/

But, to be quite honest, I have no idea how useful the style guide is,
given that it hasn't been touched in years.

We used it as a reference for our documentation work at Tails:
>
> https://tails.boum.org/contribute/how/documentation/guidelines/
>
> Are there any plans to put it back online? Update it?
>

I'd be happy to publish a style guideline for application documentation
that is relevant to GNOME in 2021. I have no plans to actually do this
work, though.

Ciao,
 Emmanuele.

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

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

<div dir=3D"ltr"><div dir=3D"ltr">On Thu, 12 Aug 2021 at 18:25, sajolida &l=
t;<a href=3D"mailto:[email protected]">[email protected]</a>&gt; wr=
ote:<br></div><div class=3D"gmail_quote"><blockquote class=3D"gmail_quote" =
style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);pa=
dding-left:1ex">Emmanuele Bassi via gnome-doc-list:<br>
&gt; <br>
&gt; I&#39;ve just announced the new version of the <a href=3D"http://devel=
oper.gnome.org" rel=3D"noreferrer" target=3D"_blank">developer.gnome.org</a=
><br>
&gt; &lt;<a href=3D"http://developer.gnome.org" rel=3D"noreferrer" target=
=3D"_blank">http://developer.gnome.org</a>&gt; website:<br>
<br>
Hi, sajolida from Tails here.<br>
<br>
Sorry I&#39;m probably very late to the dance but I now see that the former=
<br>
GNOME Documentation Style Guide disappeared from the new<br>
<a href=3D"http://developer.gnome.org" rel=3D"noreferrer" target=3D"_blank"=
>developer.gnome.org</a>:<br>
<br>
<a href=3D"https://developer.gnome.org/gdp-style-guide/" rel=3D"noreferrer"=
 target=3D"_blank">https://developer.gnome.org/gdp-style-guide/</a></blockq=
uote><div><br></div><div>The guide is still available on the snapshot of th=
e old developers documentation site:</div><div><br></div><div><a href=3D"ht=
tps://developer-old.gnome.org/gdp-style-guide/stable/">https://developer-ol=
d.gnome.org/gdp-style-guide/stable/</a></div><div><br></div><div>But, to be=
 quite honest, I have no idea how useful the style guide is, given that it =
hasn&#39;t been touched in years.</div><div><br></div><blockquote class=3D"=
gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(20=
4,204,204);padding-left:1ex">
We used it as a reference for our documentation work at Tails:<br>
<br>
<a href=3D"https://tails.boum.org/contribute/how/documentation/guidelines/"=
 rel=3D"noreferrer" target=3D"_blank">https://tails.boum.org/contribute/how=
/documentation/guidelines/</a><br>
<br>
Are there any plans to put it back online? Update it?<br></blockquote><div>=
<br></div><div>I&#39;d be happy to publish a style guideline for applicatio=
n documentation that is relevant to GNOME in 2021. I have no plans to actua=
lly do this work, though.</div><div><br></div>Ciao,</div><div class=3D"gmai=
l_quote">=C2=A0Emmanuele.<br clear=3D"all"></div><br>-- <br><div dir=3D"ltr=
" class=3D"gmail_signature"><a href=3D"https://www.bassi.io" target=3D"_bla=
nk">https://www.bassi.io</a><br>[@] ebassi [@<a href=3D"http://gmail.com" t=
arget=3D"_blank">gmail.com</a>]</div></div>

--00000000000025aab005c96083a9--

--===============4974518299960740264==
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

--===============4974518299960740264==--