Skip to content

Conversation

@Ivorforce
Copy link
Member

We just had someone confused about the entry_symbol section in Discord.

I decided to have a quick look over the document and address some issues:

  • Guide users the full way to running the project.
  • Make it clearer that changing the names is not immediately required, to get them started faster.
  • Add some links to make it easier to navigate.

@Ivorforce Ivorforce added the enhancement New feature or request label Oct 25, 2025
@dsnopek
Copy link
Contributor

dsnopek commented Oct 27, 2025

Make it clearer that changing the names is not immediately required, to get them started faster.

I think it's good to tell people to change the name of the entry symbol right away, because once things are working, it seems likely that folks will forget to come back and change it. And on some platform the dynamic linker will do really strange things if you load two libraries that have the same exported symbol, and by the time folks encounter that issue, it will be non-obvious to come back to the entry symbol.

@Ivorforce Ivorforce force-pushed the usage-update branch 2 times, most recently from 68509e9 to 424593c Compare October 27, 2025 13:22
@Ivorforce
Copy link
Member Author

Ivorforce commented Oct 27, 2025

Makes sense. I changed the structure to interweave it with the setup instructions again.

Copy link
Contributor

@dsnopek dsnopek left a comment

Choose a reason for hiding this comment

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

Thanks! This looks good to me :-)

The only thought I have is that this removes the note about the docs in doc_classes/ and it would be nice to say something about it, but I'm not sure where it should say it, so I think this is fine for now

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants