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

Question: Does/could the manifest-to-markdown package allow for the creation of custom sections? #59

Open
michaelwarren1106 opened this issue Mar 10, 2021 · 2 comments

Comments

@michaelwarren1106
Copy link

michaelwarren1106 commented Mar 10, 2021

For example, if I wanted to separate out certain properties as special ones, maybe even by adding a special jsdoc-like indicator (like @specialProp or something) how might i go about making a custom section in the produced markdown?

The use case I have is that my web components have what I call "Internal Access properties" that give consumers of the components direct access to certain important DOM elements directly rather than them having to crawl the internal shadowRoot with nested querySelectors. It would be awesome if i could specify some tag on those properties and have them get broken out into their own special category section with a name and table columns I could specify add to, etc.

@thepassle
Copy link
Member

Currently this is not possible (the render to markdown functionality is pretty basic right now), but I think this is a good usecase, we could probably accept a callback or some kind of 'plugin' functionality to customise the markdown output 👍

@michaelwarren1106
Copy link
Author

Awesome, i wouldn't mind trying to dig in there a little bit since the usecase is definitely something that we would need. I'll see if i've got some time to devote to poking around the code and seeing how i might get something at least functional

the other thing i wanted to mention, but wasnt sure which package would be best to suggest it for is a CLI option in the analyze tool for generating the markdown from the toMarkdown package directly. I currently use wca and use the markdown option pretty extensively so that would help this new pkg be a replacement for wca for me.

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

2 participants