Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: Remove attic classes from Doxygen #12795

Merged

Conversation

jwnimmer-tri
Copy link
Collaborator

@jwnimmer-tri jwnimmer-tri commented Mar 1, 2020

When attic modules are shown in the C++ documentation, there is noting that highlights them as legacy or to-be-deprecated so it is too easy for users to stumble into misleading information.

(Note that for pydrake, attic code lives in the attic module so at least the information is segregated.)

Relates #12158.


This change is Reviewable

When attic modules are shown in the C++ documentation, there is noting that
highlights them as legacy or to-be-deprecated so it is too easy for users to
stuble into misleading information.

(Note that for pydrake, attic code lives in the attic module so at least the
information is segregated.)
@jwnimmer-tri
Copy link
Collaborator Author

+@EricCousineau-TRI +@sherm1 +@SeanCurtis-TRI for review, please.

Copy link
Member

@sherm1 sherm1 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sweet! :lgtm:

Reviewed 1 of 1 files at r1.
Reviewable status: LGTM missing from assignees SeanCurtis-TRI(platform),EricCousineau-TRI(platform) (waiting on @EricCousineau-TRI and @SeanCurtis-TRI)

Copy link
Contributor

@SeanCurtis-TRI SeanCurtis-TRI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:LGTM:

Death to attic links!

Reviewed 1 of 1 files at r1.
Reviewable status: LGTM missing from assignee EricCousineau-TRI(platform) (waiting on @EricCousineau-TRI)

Copy link
Contributor

@EricCousineau-TRI EricCousineau-TRI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:lgtm_strong:

Reviewed 1 of 1 files at r1.
Reviewable status: :shipit: complete! all discussions resolved, LGTM from assignees SeanCurtis-TRI(platform),EricCousineau-TRI(platform),sherm1(platform)

@jwnimmer-tri jwnimmer-tri merged commit c587248 into RobotLocomotion:master Mar 2, 2020
@jwnimmer-tri jwnimmer-tri deleted the doc-doxygen-no-attic branch March 2, 2020 01:42
jwnimmer-tri added a commit to jwnimmer-tri/drake that referenced this pull request Mar 2, 2020
When attic modules are shown in the C++ documentation, there is noting that
highlights them as legacy or to-be-deprecated so it is too easy for users to
stumble into misleading information.

(Note that for pydrake, attic code lives in the attic module so at least the
information is segregated.)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants