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

Add README section for host modules #518

Closed
wants to merge 2 commits into from
Closed

Conversation

electrum
Copy link
Collaborator

@electrum electrum commented Sep 8, 2024

No description provided.

Copy link
Collaborator

@andreaTP andreaTP left a comment

Choose a reason for hiding this comment

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

Thanks for the docs!

Since we are not really done with CString and Buffer I would leave those out from the documentation a little longer.

README.md Show resolved Hide resolved
<path>
<groupId>com.dylibso.chicory</groupId>
<artifactId>function-processor</artifactId>
<version>0.0.12</version>
Copy link
Collaborator

Choose a reason for hiding this comment

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

What about using a placeholder for the version number?
Alternatively, it needs to be updated by the release process by this script:
https://github.com/dylibso/chicory/blob/main/scripts/update-readme-version.sh

Copy link
Collaborator Author

@electrum electrum Sep 9, 2024

Choose a reason for hiding this comment

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

Looks like the script will already update it, as it's the same format as a normal dependency?

Edit: seems we need to make the leading white space in the regex more flexible.

@andreaTP
Copy link
Collaborator

This needs to target the new docs site.

Maybe a good first issue for @kanatohodets that demonstrated interest in working on the documentation side?

kanatohodets added a commit to kanatohodets/chicory that referenced this pull request Oct 29, 2024
This commit moves the README additions from
dylibso#518 into the docs site.

Per Andrea's feedback on that PR, I removed mentions of `@Buffer` or
`@CString`.
andreaTP pushed a commit that referenced this pull request Oct 30, 2024
Following up on #518, this moves @electrum's Host Module docs into the
docs site. I omitted mentions of `@Buffer` and `@CString` since Andrea's
feedback on #518 mentioned that those are still in flux.

Also tossed off a script to replace `scripts/update-readme-version.sh`.
Same thing but a Perl script which crawls the `docs/docs` dir for any
markdown files and swaps `DOCS_PLACEHOLDER_VERSION` for the given value.

I did take a quick look into Docusaurus plugins to handle this, but I
think I'd need a custom remark plugin and I didn't have capacity to go
down that road.
@andreaTP
Copy link
Collaborator

Superseded by #628

@andreaTP andreaTP closed this Oct 30, 2024
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 participants