Re: RFC: docs website layout demo

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 02/24/2015 04:49 PM, Brian (bex) Exelbierd wrote:
> Should we have styling more like the getfedora.org site? Fedora Magazine?  The Spins page?  I think we can easily take some of their visual elements.

Possibly, I'm only making the base for that kind of work to follow on.

> The layout is quite nice though.  Once we are ready to generate docs in whatever tool-chain we want, it will be awesome.

This is orthogonal to such changes.

i.e. get what is there up to date, as it's actually pretty simple, and
shouldn't be delayed because other changes might happen later.

e.g. you can use this updated tool-chain and style on the same humongous
git repo currently used for publishing, or you can use the RPM based
site approach, or you can use some CI to generate the publican website
and rsync/git commit it, etc, etc, none of those choices affect this change.

Bigger changes, such as a CMS, or even a CI really, are probably going
to take a while to get in to place, so you can still make this change
now and it'll just make peoples lives easier in the meantime.

> Did you give any thought as to how to help users understand why we have three categories of documentation for each release?

You mean the groups? e.g. "Getting started", "System administration", etc?

If so, then I just made those up to demonstrate how you can group
things. I'd expect the docs team to actually specify the real groupings
_if_ they want them :)

FWIW they are used on the Red Hat docs site and no one has ever
complained about them so I don't think they cause any confusion.

>  Should we now group by the fedora.next groupings?

This is orthogonal to this demo as you can easily change groups once the
updated tool chain is being used.

FWIW If you take a look at the Red Hat docs you will not see this kind
of division even though RH have been doing variants for a long time.

I think it'd be a lot of work and/or duplication to split up the docs to
cover variants.

Cheers, Jeff.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.14 (GNU/Linux)

iQEcBAEBAgAGBQJU7QESAAoJELs3R4zxGZvK944H/1lY5RL9lHthBs1dnqjd9ATM
CA6Y7wDRwLWU/XCo6t+KsoIwQuSCdmF3i9t5wYUlFVJ4gunsaPIRdAi9CN1z0mr8
r2+3ad/1blt0YsnCuZhTO8yWA9NeQrgUNFrOY1+njXSsT6v3COrkuvWvJzT/GV91
LDudzuBT/NRAiUGQ7i9+lkUJ0B8lpd3ZGBuLLGIOTvnZj2rz9ra+wemWOaIFmMqi
uCVaOcn112xs9/Fq26GVVYHxZcYAlbxGpoiQYJE2twU0t0nLeqirzMOnC5TybbDV
lFTsrW9DWDuytvYd/R6oeJzCSfjIb3HFXEUSqXIRV7nWNwAb7++UJk+s3ViTImA=
=bXqV
-----END PGP SIGNATURE-----
-- 
docs mailing list
docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs





[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux