Skip to content

DOC: add the 'domain' option to the docs#80

Merged
larsoner merged 3 commits intoscientific-python:masterfrom
bsipocz:doc_domain
Aug 7, 2025
Merged

DOC: add the 'domain' option to the docs#80
larsoner merged 3 commits intoscientific-python:masterfrom
bsipocz:doc_domain

Conversation

@bsipocz
Copy link
Member

@bsipocz bsipocz commented Jul 24, 2025

I tagged the release before noticing the docs didn't end up in the README page. (Also did a minor cleanup as things got renamed, but then I don't see much sense in referring to the status.yml in the readme)

@bsipocz bsipocz requested a review from stefanv July 24, 2025 03:31
@bsipocz bsipocz added the documentation Improvements or additions to documentation label Jul 24, 2025

## Example usage

Sample `.github/workflows/main.yml`:
Copy link
Member

Choose a reason for hiding this comment

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

I'm curious, don't you think it's useful to know where this typically is placed?

Copy link
Member Author

Choose a reason for hiding this comment

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

Ahh, ok. There used to be a main.yml file here that evolved and I didn't think it was useful to refer to that one. But I can add this back with a more descriptive filename instead.

README.md Outdated
artifact-path: 0/test_artifacts/root_artifact.md
circleci-jobs: build_doc
job-title: Check the rendered docs here!
domain: output.circle-artifacts.com # or a proxy address to work around routing issues
Copy link
Member

Choose a reason for hiding this comment

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

My recommendation would probably to leave it blank, not to fill it with the default value.

Copy link
Member Author

Choose a reason for hiding this comment

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

is blank an accepted option?

Copy link
Member

Choose a reason for hiding this comment

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

Erm, I'm not sure... I guess blank will overwrite the default? But I haven't tried!

bsipocz and others added 2 commits July 23, 2025 23:07
Co-authored-by: Stefan van der Walt <stefan@mentat.za.net>
@larsoner larsoner merged commit 1225cf6 into scientific-python:master Aug 7, 2025
5 checks passed
@larsoner
Copy link
Collaborator

larsoner commented Aug 7, 2025

Comments addressed, thanks @bsipocz !

@bsipocz bsipocz deleted the doc_domain branch August 7, 2025 14:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants