[
https://issues.apache.org/jira/browse/SOLR-15800?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17444878#comment-17444878
]
Jan Høydahl commented on SOLR-15800:
------------------------------------
[~houston] - my proposal was a Jenkins job triggered by commit (and filtered by
whether the ref-guide was changed), i.e. zero steps for RM.
{quote}Sure the DRAFT watermark is kinda neat, but if it's in the way of
automating, maybe it's not neat enough?
{quote}
[~gus] - DRAFT can be toggled on or off during build. We already have a Jenkins
job for main branch, which builds the guide to some ci-URL. What we need is a
new Jenkins job that does almost the same, but for release branches (I like
your idea of scanning git tags, although then you'd need to tag every refguide
bugfix - so better scan {{branch_(\d+)_(\d+)}} and build those as
{{{}https://solr.apache.org/guide/$1_$2{}}}.
> Make publishing the Ref Guide a step in the release process
> -----------------------------------------------------------
>
> Key: SOLR-15800
> URL: https://issues.apache.org/jira/browse/SOLR-15800
> Project: Solr
> Issue Type: Task
> Security Level: Public(Default Security Level. Issues are Public)
> Components: documentation
> Reporter: Cassandra Targett
> Priority: Blocker
> Time Spent: 0.5h
> Remaining Estimate: 0h
>
> Publishing the Ref Guide for each release is still done "outside" the Solr
> artifact release process, done basically manually by a single person. So when
> she isn't available, it seems to often get skipped.
> If we agree that the Ref Guide is an important part of the release, and that
> we should release a new version in conjunction with the artifacts, then it
> should be part of the overall release process.
> I don't understand the release process or wizard well enough to know how to
> integrate the steps, so cannot tackle this myself.
> The steps are documented in our source repo:
> https://github.com/apache/solr/blob/main/dev-docs/ref-guide/publish.adoc
--
This message was sent by Atlassian Jira
(v8.20.1#820001)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
