Skip to content

docs: Add Deprecated names of variables #574

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.

Sign up for GitHub

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

Jump to bottom
Open
wants to merge 4 commits into
base: dev
Choose a base branch
from
Open

docs: Add Deprecated names of variables #574

wants to merge 4 commits into from

Conversation

@kareefardi
Copy link
Contributor

@kareefardi kareefardi commented Oct 8, 2024 •
edited
Loading

Variables

  • Fix unhashable Variable

Docs

  • Add deprecated names to Variable
  • Avoid duplicate entries for a Variable for a specific Step

resolves #526

@kareefardi
docs: Add Deprecated Names to Variable table
23e7b66 
remove FP_DEF_TEMPLATE for OpenROADStep config_vars

Signed-off-by: Kareem Farid <kareefardi@users.noreply.github.com>
@openlane-bot
Copy link
Collaborator

openlane-bot commented Oct 8, 2024 •
edited
Loading

Metric comparisons are in beta. Please report bugs under the issues tab.

To create this report yourself, grab the metrics artifact from the CI run, extract them, and invoke python3 -m openlane.common.metrics compare-remote current --branch dev --table-verbosity ALL --table-out ./tables_all.md.

  • No changes to critical metrics were detected in analyzed designs.

Full tables ► https://gist.github.com/openlane-bot/50c91a8a5570f600f996a53bfa539557

@kareefardi
Restore FP_DEF_TEMPLATE in OpenROADStep to avoid breakingchange
cc018f3 
Iterate on set of unique Variables when generating docs for a step
Update __hash__ for Variable to avoid unhashable list

Signed-off-by: Kareem Farid <kareefardi@users.noreply.github.com>
@kareefardi kareefardi changed the title docs: Add Deprecated Names to Variable table docs: Add Deprecated names of variables Oct 8, 2024
@kareefardi kareefardi marked this pull request as ready for review October 8, 2024 12:43
donn
donn requested changes Oct 9, 2024
View reviewed changes
Copy link
Collaborator

@donn donn left a comment

Choose a reason for hiding this comment

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

To implement this properly, you have to create HTML tables in place of the Markdown tables. There's almost no way around it.

Additionally while you're doing that, I think the best approach would be to have a collapsible below the current name- another column occupies precious horizontal real estate

openlane/flows/flow.py
units = var.units or ""
pdk_superscript = "<sup>PDK</sup>" if var.pdk else ""
result += f"| `{var.name}`{{#{var._get_docs_identifier(Self.__name__)}}}{pdk_superscript} | {var.type_repr_md()} | {var.desc_repr_md()} | `{var.default}` | {units} |\n"
result += f"| `{var.name}`{{#{var._get_docs_identifier(Self.__name__)}}}{pdk_superscript} | {var.type_repr_md()} | {var.desc_repr_md()} | `{var.default}` | {units} | {'<br>'.join(var.get_deprecated_names_md())} |\n"
Copy link
Collaborator

@donn donn Oct 9, 2024

Choose a reason for hiding this comment

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

ditto

openlane/steps/step.py
units = var.units or ""
pdk_superscript = "<sup>PDK</sup>" if var.pdk else ""
result += f"| `{var.name}`{{#{var._get_docs_identifier(Self.id)}}}{pdk_superscript} | {var.type_repr_md(for_document=True)} | {var.desc_repr_md()} | `{var.default}` | {units} |\n"
result += f"| `{var.name}`{{#{var._get_docs_identifier(Self.id)}}}{pdk_superscript} | {var.type_repr_md(for_document=True)} | {var.desc_repr_md()} | `{var.default}` | {units} | {'<br>'.join(var.get_deprecated_names_md())} |\n"
Copy link
Collaborator

@donn donn Oct 9, 2024

Choose a reason for hiding this comment

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

ditto

@kareefardi kareefardi requested a review from donn October 10, 2024 13:59
@kareefardi
Copy link
Contributor Author

kareefardi commented Oct 10, 2024

To implement this properly, you have to create HTML tables in place of the Markdown tables. There's almost no way around it.

Additionally while you're doing that, I think the best approach would be to have a collapsible below the current name- another column occupies precious horizontal real estate

There was an issue in forming the markdown table which is now fixed.

As for the collapsable, I don't think it is necessary. Deprecated names are added so that they are viewable when search the docs - or using Ctrl+f. The PR accomplishes that.

@donn
Copy link
Collaborator

donn commented Oct 10, 2024

Ctrl + F works with collapsible though, no?

@kareefardi
Copy link
Contributor Author

kareefardi commented Oct 10, 2024 •
edited
Loading

Ctrl + F works with collapsible though, no?

Apparently not. The importing part is not matched by Ctrl + F in the current docs

Edit:
I am open to other suggestions thou.

@ohl-bot ohl-bot mentioned this pull request Apr 18, 2025
Closed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@donn donn Awaiting requested review from donn

Requested changes must be addressed to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@kareefardi @openlane-bot @donn