Skip to content

Revisit the need of DOCLET_VERSION env variable (in Jan 2023) #8754

Closed

Description

@suztomo

In Jan 2023, let's revisit the need of if statement and the environment variable to specify doclet version in #8753.

Activity

  1. added
    type: feature request‘Nice-to-have’ improvement, new feature or different behavior or design.
    priority: p3Desirable enhancement or fix. May not be included in next release.
    on Nov 9, 2022
  2. lqiu96 commented on Nov 9, 2022

    @lqiu96
    Member

    There is an issue in java-docfx-doclet for publishing the doclet artifact to maven central: googleapis/java-docfx-doclet#105. I think this should be the long term solution so that we don't need to manually update the version in shared-configs.

    DOCLET_VERSION is not needed by default (since shared-configs is specifying the version). I kept the env_var in g3 so that we can publish/update docs by manually setting the DOCLET_VERSION env_var in the fusion job. This is so that we can publish/ update docs even if there is an issue in any future version of the doclet. We can manually rollback the doclet version and publish docs without having to wait for shared-configs' doclet version rollback to be released.

  3. alicejli commented on Dec 12, 2023

    @alicejli
    Contributor

    I think this property can be removed from java-shared-config in general as the publish_javadoc11.sh job is now within google3 and doesn't use this property AFAIK. @burkedavison wdyt?

  4. burkedavison commented on Dec 12, 2023

    @burkedavison
    Member

    Agreed. Not used. Can be removed.

  5. alicejli commented on Mar 27, 2024

    @alicejli
    Contributor

    Closing this issue as the doclet is managed in java-shared-config and the release scripts are in g3 now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

priority: p3Desirable enhancement or fix. May not be included in next release.type: feature request‘Nice-to-have’ improvement, new feature or different behavior or design.

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions