fedora-magazine-newsroom

#215 Docs Workshop
Closed: published by rlengland. Opened by rlengland.

Closed: published
Reopen Issue

Article Summary:

The Docs workshop aims to empower people to learn about templates, issue tickets, review processes, and tool chains to improve documentation for Fedora Linux users and contributors.

See the link on ideation.

Article Description:

To begin with, we could consider gentle introduction on experiences of Docs contributors. We love to hear from hallway track @Flock. That’ll be valuable lessons.

Building on feedback from each session, add more hands-on workshop like below;

  • Introduction on Pagure web interface
  • Interactions with issue tickets and reviewers
  • How to select articles to review
  • How to use AsciiDoc markup
  • How to use local preview and why
  • How to create a new article
  • Best practices

https://discussion.fedoraproject.org/t/article-proposal-docs-workshop/87377

Metadata Update from @rlengland:
- Issue assigned to hankuoffroad
- Issue tagged with: article, needs-image

Metadata Update from @hankuoffroad:
- Custom field preview-link adjusted to https://fedoramagazine.org/?p=38668&preview=1&_ppp=d989530d6a

Draft uploaded for preview.

Added Peter Boy as a co-author.
@pboy could you advise if you want to add or change the article?
Edited by hankuoffroad

Metadata Update from @rlengland:
- Custom field preview-link adjusted to https://fedoramagazine.org/?p=38668&preview=1 (was: https://fedoramagazine.org/?p=38668&preview=1&_ppp=d989530d6a)

Metadata Update from @hankuoffroad:
- Custom field preview-link adjusted to https://fedoramagazine.org/?p=38668&preview=1&_ppp=df29199107 (was: https://fedoramagazine.org/?p=38668&preview=1)

Metadata Update from @hankuoffroad:
- Custom field preview-link adjusted to https://fedoramagazine.org/?p=38668&preview=1&_ppp=e63e08c7ac (was: https://fedoramagazine.org/?p=38668&preview=1&_ppp=df29199107)

Metadata Update from @hankuoffroad:
- Custom field preview-link adjusted to https://fedoramagazine.org/?p=38668&preview=1&_ppp=a691d73c80 (was: https://fedoramagazine.org/?p=38668&preview=1&_ppp=e63e08c7ac)

Metadata Update from @hankuoffroad:
- Custom field preview-link adjusted to https://fedoramagazine.org/?p=38668&preview=1&_ppp=ee09e1f01b (was: https://fedoramagazine.org/?p=38668&preview=1&_ppp=a691d73c80)

Metadata Update from @hankuoffroad:
- Custom field preview-link adjusted to https://fedoramagazine.org/?p=38668&preview=1&_ppp=6cc8479e78 (was: https://fedoramagazine.org/?p=38668&preview=1&_ppp=ee09e1f01b)

This should go out ASAP. If we are starving for content why is this not scheduled?

It looks like it is waiting on a response from Peter.

Isn't the event scheduled for sept 15? that doesn't leave much time for readers to digest the info and get on board to help. That's all I was wondering.

It's news to me. (I haven't looked at the article yet.)

Hi, this is the line that stands out to me, even though it is the beginning time frame that is being talked about, "If you fancy coming along, just let us know your preferred timeslot in When-is-good scheduler by September 15 2023."
My whole point being to get people to on board for something like documentation, especially since it is technical, can be a task. Time may provide prospective contributors a space to seriously consider it. You know people tend to like to go into things prepared for them.
Edited by jakfrost

I just did an editing pass on this article. I guess we can assume that Peter would have commented if there was reason to do so.

@glb I think it an be published but feel free to read through it. I'll let you pull the trigger as soon as you deem it ready.

Metadata Update from @glb:
- Custom field editor adjusted to rlengland
- Custom field image-editor adjusted to glb
- Custom field publish adjusted to 2023-08-25
- Issue untagged with: needs-image

Metadata Update from @glb:
- Custom field preview-link adjusted to https://fedoramagazine.org/docs-workshop-virtually-writing-together/ (was: https://fedoramagazine.org/?p=38668&preview=1&_ppp=6cc8479e78)

This has been scheduled to go out at the top of the hour.

I haven't changed the date on the last paragraph. September 15 is the last date of response on When is good scheduler. People are given date range between 18 - 28 September. So, the date on last paragraph needs to be end of September without a specific date. @rlengland could you change that?

Edited by hankuoffroad

Isn't the event scheduled for sept 15? that doesn't leave much time for readers to digest the info and get on board to help. That's all I was wondering.

Thanks for your heads-up. However, September 15 is response date, not the date the workshop kicks off.

September 15 is the last date of response on When is good scheduler. People are given date range between 18 - 28 September. So, the date on last paragraph needs to be end of September without a specific date.

I've changed the last sentence to make that clear.

Issue status updated to: Closed (was: Open)
Issue close_status updated to: published
Metadata

article

None
None
None
Static archive. pagure.io was sunset in 2026; this is a read-only snapshot.
Red Hat Logo

Fedora is sponsored by Red Hat. Learn more about the relationship between Red Hat and Fedora »

© Red Hat, Inc. and others.