fedora-diversity

#117 partials: Add reusable macros for all D&I team docs
Merged by jflory7. Opened by jflory7.
add/reusable-macros  into  master

Download 117.patch

This commit adds a _partials/attributes.adoc file. This is a special
file that includes macros that can be reused across all Antora docs
pages. To reuse any of these macros, you wrap them around curly
brackets.

For example, to get https://communityblog.fedoraproject.org to appear on
a page, write {{COMMBLOG}} to embed the macro.

Metadata Update from @jflory7:
- Pull-request tagged with: improvement, type - docs

ACK :thumbsup:

Metadata Update from @jflory7:
- Request assigned

Pull-Request has been merged by jflory7

Thanks for doing it and Sorry for the late comment.
Why we need - :YEAR: 2020 ?
both are 4 letters/numbers, I mean same number of keystrokes and year will keep changing as well?

:FISCALYEAR: FY20 will also change. I think it should be :FISCALYEAR20: FY20 ?

@amsharma These are macros we can use across all of our doc pages. For example, say we have two different pages that refer to the fiscal year:

index.adoc:
Planning for {FISCALYEAR} includes these goals:

policy/decision-process.adoc:
*Full consensus* is required to approve new processes, make changes to existing team policies, and tickets requiring https://budget.fedoraproject.org/budget/{FISCALYEAR}/d-i.html[D&I budget].

Instead of going to each page and manually changing the fiscal year by hand, you only need to update the attribute in _partials/attributes.adoc. Changing the attribute there will update the text used anywhere the attribute is used. It makes it easier for us to account for changes over time and avoid mistakes by forgetting to update a link.

Does this make sense?
Metadata
nikhilkathole

improvement type - docs

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.