web-docscontrib #55

Merged
pbokoc merged 4 commits from egret/team-docs:web-docscontrib into main 2026-04-12 11:46:16 +00:00
Member
  • Added page on editing using Forge web interface
  • Amended nav file
  • Update links from Gitlab and Pagure pages
- Added page on editing using Forge web interface - Amended nav file - Update links from Gitlab and Pagure pages
pbokoc requested changes 2026-04-11 12:19:25 +00:00
Dismissed
@ -0,0 +13,4 @@
== Edit via the Forge web interface
Every documentation page has an icon:edit[] *Edit this page* button.
Owner

We should point out it's in the top right corner - these icons are tiny so they're hard to find if you don't know where to look.

We should point out it's in the top right corner - these icons are tiny so they're hard to find if you don't know where to look.
egret marked this conversation as resolved
@ -0,0 +22,4 @@
2. If you are not already signed in, do so with your FAS account.
3. Click the *Fork* button (normally top right). If prompted, enter the details to create your new fork. The default values are suitable in most cases.
Owner

This doesn't seem to be necessary. I'm checking on a repo I haven't forked before, and you can just go ahead and click edit without forking first. Same with step 4 below.

This doesn't seem to be necessary. I'm checking on a repo I haven't forked before, and you can just go ahead and click edit without forking first. Same with step 4 below.
Author
Member

Can we double check this one somehow? It was grayed out for me.

Can we double check this one somehow? It was grayed out for me.
Owner

Right, my bad, I didn't need to do that because I have permissions to push directly, but most people won't.

Right, my bad, I didn't need to do that because I have permissions to push directly, but most people won't.
pbokoc marked this conversation as resolved
@ -0,0 +28,4 @@
4. Manually navigate the folder structure to return to the source page you intend to edit (normally in modules/ROOT/pages/).
5. Click the icon:pen[] *Edit* button, and make your changes directly to the AsciiDoc code.
Owner

Again, let's point out where the button is (to the right above of the file contents).

Again, let's point out where the button is (to the right above of the file contents).
egret marked this conversation as resolved
@ -0,0 +30,4 @@
5. Click the icon:pen[] *Edit* button, and make your changes directly to the AsciiDoc code.
6. Use the icon:eye[] *Preview* button to see how the document will look. Keep in mind that some AsciiDoc elements may not render accurately in the preview.
Owner

Same as above - on the left side above the edit field.

Same as above - on the left side above the edit field.
egret marked this conversation as resolved
egret force-pushed web-docscontrib from 9cc6171e03 to f00ee725e2 2026-04-12 10:53:41 +00:00 Compare
pbokoc approved these changes 2026-04-12 11:45:52 +00:00
Owner

Alright, then, everything looks good. Thanks!

Alright, then, everything looks good. Thanks!
pbokoc merged commit f00ee725e2 into main 2026-04-12 11:46:16 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
docs/team-docs!55
No description provided.