[
https://issues.apache.org/jira/browse/SOLR-15800?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17444829#comment-17444829
]
Houston Putman commented on SOLR-15800:
---------------------------------------
In my opinion, having this in the ref-guide is much simpler than having it be a
jenkins job. There are already multiple extremely similar tasks in the release
wizard, such as uploading the java docs, the artifacts, etc. (run a gradle
command, then add to svn) This is another one of these that the release manager
has to do, instead of adding a new type of task (i.e. go and run a jenkins job).
The less places we have logic for a release, the better IMO. And it's not like
we need to go and re-push a ref-guide very often (and if we do, it's likely
because there was a problem during the upload, which could be solved by having
it automated in the release wizard).
This isn't a hill I'm going to die on, but I would prefer leaving all of the
logic in the release wizard.
> 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]
