owncloud / ocis

:atom_symbol: ownCloud Infinite Scale Stack
https://doc.owncloud.com/ocis/next/
Apache License 2.0
1.31k stars 169 forks source link

Docs helpers need to manage the future release placeholder %%NEXT%% #9316

Closed mmattel closed 1 week ago

mmattel commented 1 month ago

Referencing: #9312 (docs: use placeholder for next release)

With the introduction of %%NEXT%% as placeholder in new variables for upcoming releases (the release number is not known at the time), we need to adapt the docs helper process to recognize that placeholder and replace it in the outcoming adoc (md) files with next (suggestion). Else the placeholder will be printed literally.

As we use next in our admin docs in the URL for the release in progress, using next as name for the introduction version sounds valid to me. Short, precise and in-line. Other suggestions welcomed.

NOTES:

@micbar @dragonchaser

dragonchaser commented 1 month ago

This is a minor change to the generator here: https://github.com/owncloud/ocis/blob/master/docs/helpers/templates/adoc-generator.go.tmpl. Also needs adaption of the adoc templates. Since the introductionVersion is not rendered atm I see this as low prio.