Skip to content

docs: overhaul example workflow and clean it up#1497

Merged
dbirman merged 13 commits into
devfrom
1484-20-overhaul-the-generating-metadata-tutorial
Jul 9, 2025
Merged

docs: overhaul example workflow and clean it up#1497
dbirman merged 13 commits into
devfrom
1484-20-overhaul-the-generating-metadata-tutorial

Conversation

@dbirman

@dbirman dbirman commented Jul 7, 2025

Copy link
Copy Markdown
Member

This PR overhauls the example_workflow to better reflect 2.0 and provide a softer introduction to the schema. You can see this specific branch here: https://aind-data-schema.readthedocs.io/en/1484-20-overhaul-the-generating-metadata-tutorial/

PR also adds a few other pending fixes to the documentation, like properly linking the PIDName class

@dbirman dbirman linked an issue Jul 7, 2025 that may be closed by this pull request
@dbirman dbirman requested a review from saskiad July 7, 2025 18:42
@dbirman dbirman linked an issue Jul 8, 2025 that may be closed by this pull request
Comment thread docs/source/example_workflow/example_workflow.md Outdated
Comment thread docs/source/example_workflow/example_workflow.md Outdated
Comment thread docs/source/example_workflow/example_workflow.md
Comment thread docs/source/components/subjects.md Outdated
|-------|------|-------------|
| `sex` | [Sex](#sex) | |
| `date_of_birth` | `datetime.date` | |
| `date_of_birth` | `typing.Annotated[datetime.date, <TimeValidation.BEFORE: 'before'>]` | |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I assume this is autogenerated? I find this not useful to explaining what the field is. But not a deal breaker.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

That's definitely a bug in the generator, should just resolve itself to "datetime.date"

@saskiad saskiad left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

see comments

@dbirman

dbirman commented Jul 9, 2025

Copy link
Copy Markdown
Member Author

Blocked by aind-data-schema-models bug

@dbirman dbirman added this pull request to the merge queue Jul 9, 2025
Merged via the queue into dev with commit cedf388 Jul 9, 2025
5 checks passed
@dbirman dbirman deleted the 1484-20-overhaul-the-generating-metadata-tutorial branch July 9, 2025 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[2.0] PIDName in docs isn't resolving properly as a class [2.0] Overhaul the generating metadata tutorial

2 participants