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

Feat: Adding a Description for Each Typescript Class and Function #114

Open
Sma1lboy opened this issue Apr 5, 2024 · 4 comments
Open

Feat: Adding a Description for Each Typescript Class and Function #114

Sma1lboy opened this issue Apr 5, 2024 · 4 comments

Comments

@Sma1lboy
Copy link

Sma1lboy commented Apr 5, 2024

  • I've noticed that there are still a lot of classes and functions that don't have any description in the Obsidian API documentation. As a result, sometimes I have to keep tracing the source code to figure it out.
    • Is there any chance we can add more descriptions.
  • I also noticed that some functions may be obsolete or removed. We can do a history trace for each function. Generate a new version of the API documentation on top of the project. I have a cool idea.
@joethei
Copy link
Contributor

joethei commented Apr 5, 2024

We are working on adding more documentation, but it's not a fast process.

I don't fully understand what you mean with the obsolete/removed functions, can you explain more?

@Sma1lboy
Copy link
Author

Sma1lboy commented Apr 6, 2024

Sorry for the typo mistake. I mean outdated or deprecated APIs. Maybe in the future. Some functions might replacement by similar functions but still keep in the source code.

So I think It might be a good idea if we trying to adding a history in API docs.

A example is Node's API document

I can do this if you think it is worth to do.

@Sma1lboy
Copy link
Author

Sma1lboy commented Apr 6, 2024

BTW, Can I make PR for adding more documentation on API docs?

@lishid
Copy link
Contributor

lishid commented Apr 13, 2024

Might be worth exploring but I would not recommend attempting to make a PR since our typescript file is generated from code and your changes will just get wiped out on the next run of the generator.

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

No branches or pull requests

3 participants