Issue with local antora docs environment
by Peter Boy
I just tried to start my local antora Fedora docs build environment and it failed:
$ ./build.sh && ./preview.sh
This build script is using Docker container runtime to run the build in an isolated environment.
Unable to find image 'antora/antora:latest' locally
latest: Pulling from antora/antora
97518928ae5f: Pull complete
16a1a5057866: Pull complete
ad8b526cbb1f: Pull complete
0328e268dee9: Pull complete
189b546b5e76: Pull complete
9cb3f4115fdb: Pull complete
f4dabaa8a81b: Pull complete
Digest: sha256:caf0d59c92c292858d6569dc8a9f4b104f85743db2eaf55f34ef0a2c97a3ef90
Status: Downloaded newer image for antora/antora:latest
[07:32:52.861] FATAL (antora): configuration param 'runtime.pull' not declared in the schema for /antora/site.yml (cwd: /antora, playbook: site.yml)
Any idea what went wrong and how to fix it?
1 year, 8 months
Project organisation
by Ryan Lerch
Promise this is the last thread i'll start til next week, but back on the docs train a little bit :)
So, how does the team think about mixing up how the team works and communicates? im thinking two seperate ideas here:
1. Archive this mailing list and move discussion for docs over to discussion.fedoraproject.org
2. Clean up all the docs repos, and move them to gitlab (specifically gitlab.com/fedora/docs) -- obviously this is a big and contentious one, but it would allow us to have subgroups for our tooling and docs, making it easier to group this stuff out. Also the way gitlab shows all tickets for groups will allow us to see issues across all our docs repos, rather than following many many repos.
cheers,
ryanlerch
1 year, 8 months
Antora docs down
by Ankur Sinha
Hiya,
(Resending without attachments)
I was looking for the package maintainer docs and hit a 404, and now when i
go to docs.fp.o, i get the old publican docs.
Are the antora docs down or is there an outage in progress (in any case we
shouldnt automatically redirect to old docs here)?
--
Thanks,
Ankur
(Sent from mobile device)
1 year, 9 months
Repos, Branches, and themes confusing
by Ryan Lerch
Hi all,
I recently jumped back into looking at docs, and took me quite a while to figure everything out, and just wondering if we could change things up a bit. follows are the things that i found confusing:
1. https://pagure.io/fedora-docs/docs-fp-o default branch is master, that hasnt been updated for two years -- should we make the default branch prod? (also the stage branch's readme still refers to https://pagure.io/fedora-docs/fedora-docs-web)
2. https://pagure.io/fedora-docs/fedora-docs-web still looks active, but it doesnt seem to be used anymore -- you don't need to push built results there, anymore right? Should this repo just be deleted, since it only ever housed built stuff anyway?
3. It took me ages to find where the static front pages were -- i finally found them at https://pagure.io/fedora-docs/pages/ but we really should update the docs docs with this information
4. Finally, the antora UI bundle -- it seems the UI bundle is being pulled from a zip on asalalik's fedora people -- and then we are adding additional changes via supplemental-ui in the docs-fp-o repo. Is there any reason we cannot merge these changes back into https://pagure.io/fedora-docs/fedora-docs-ui start doing numbered releases of these bundles, and hosting the built zips on gitlab or pagure, and pulling from there rather than fedorapeople?
cheers,
ryanlerch
1 year, 9 months
QuickDocs inquiry
by Bill Cozens
Hey all,
I'm new to docs (and Fedora in general) and I'm looking to get involved
with Quick Docs. As it stands now, however, I feel like I lack the
technical expertise to make a meaningful contribution to it. To that end I
wanted to ask SMEs in the community if they would change anything in the
Quick Docs - and from there, offering to translate their thoughts into
documentation. Basically like an SME interview sort of thing.
That being said, is anybody here willing/can anyone point me in the right
direction to people who might be willing to do this sort of thing with me?
Thanks a ton.
- Bill
1 year, 9 months
docs.fedoraproject.org front page suggestions
by Matthew Miller
Search is the leading problem, but I think we can probably clean up the
navigation quite a bit. It just kind of ... grew this way.
1. Remove F34 and Rawhide bubbles. Let's just feature the latest. If we want
older release docs to be more prominent, we can style the version-changer
more prominently.
2. Definitely remove links to the really old docs, as previously discussed.
3. Having EPEL on the front page separately still seems good, considering the
user base and that EPEL is one of the most popular queries leading to the
site.
4. I'm unsure about front page bubbles, but -- I think we should put all of
the Edition / spin documentation into one three-level hierarchy instead
of lots of two-level ones.
5. I still kind of like "Fedora Project" as a little mini-site, but maybe
_all_ of the rest of Fedora Council, Engineering Teams, Mindshare Teams,
D&I, PgMT should be put into one?
6. Not sure where stuff like Gaming should go.
7. Packaging guidelines and to-be-added Legal... same.
8. Outreachy docs should be removed, since they're not on the docs site.
9. GCP should be removed because we're not doing that anymore.
--
Matthew Miller
<mattdm(a)fedoraproject.org>
Fedora Project Leader
1 year, 9 months