# \[Article proposal\] Docs workshop

**URL:** <https://discussion.fedoraproject.org/t/article-proposal-docs-workshop/87377>\
**Category:** Fedora Magazine\
**Tags:** commops-team, marketing-team, docs-team\
**Created:** [August 12, 2023, 12:17pm UTC](https://discussion.fedoraproject.org/t/article-proposal-docs-workshop/87377 "2023-08-12T12:17:48Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![hankuoffroad](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/hankuoffroad/32/43282_2.png) [@hankuoffroad](https://discussion.fedoraproject.org/u/hankuoffroad)\
**Post date:** [August 12, 2023, 12:17pm UTC](https://discussion.fedoraproject.org/t/article-proposal-docs-workshop/87377/1 "2023-08-12T12:17:48Z")

</div>

**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](https://discussion.fedoraproject.org/t/write-together-virtually/82564/4).

**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

---

<div class="post-metadata">

**Author:** ![glb](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/glb/32/570_2.png) [@glb](https://discussion.fedoraproject.org/u/glb)\
**Post date:** [August 12, 2023, 4:40pm UTC](https://discussion.fedoraproject.org/t/article-proposal-docs-workshop/87377/2 "2023-08-12T16:40:59Z")

</div>

This sounds great! +1! 🙂

---

<div class="post-metadata">

**Author:** ![rlengland](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/rlengland/32/1915_2.png) [@rlengland](https://discussion.fedoraproject.org/u/rlengland)\
**Post date:** [August 12, 2023, 6:01pm UTC](https://discussion.fedoraproject.org/t/article-proposal-docs-workshop/87377/3 "2023-08-12T18:01:09Z")

</div>

@hankuoffroad[Pagure Ticket #215](https://pagure.io/fedora-magazine-newsroom/issue/215) has been opened to track your article.

As usual, let us know the WP preview link as a comment on that ticket when you are ready for review or have any questions.

Thanks, again.

---

<div class="post-metadata">

**Author:** ![system](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/system/32/2604_2.png) [@system](https://discussion.fedoraproject.org/u/system)\
**Post date:** [February 8, 2024, 12:18pm UTC](https://discussion.fedoraproject.org/t/article-proposal-docs-workshop/87377/4 "2024-02-08T12:18:44Z")

</div>

This topic was automatically closed after 180 days. New replies are no longer allowed.