Comments (4)
Hi @eerison
That's the right place for this question.
I have plan to make the solution more agnostic, ie not dependent on Docusaurus.
The work is in progress, and I expect to have something by early summer.
from graphql-markdown.
I am working on this too within my company. We have a prototype ready and working which will go out in some weeks (nothing yet finalized).
We reused @graphql-markdown/utils
for parsing schema and then we generate routes and return props. We're dealing with caching now to speed up some of the elaboration.
from graphql-markdown.
I have plan to make the solution more agnostic, ie not dependent on Docusaurus.
The work is in progress, and I expect to have something by early summer
Work is still in progress. Most of the ground work has been done, ie clean up the code and migrating to TS, adding documentation in the code. This is currently available in 1.21.0-next.0 and following (pre-releases only).
I am exploring the next step that is moving away from a messy architecture (the latest clean up improve the code, but not the architecture), to a cleaner one based on NestJS. I don't know yet if NestJS will be the final solution, but I will for sure move the code into a "mature" NodeJS framework offering a better code structure, and DI.
A top of it, I'll add more API documentation, so one can quickly reuse the libraries for custom export format.
👉 This will be the 2.0.
Once the framework migration is done with feature parity to current 1.x, the next steps will be moving away from the current homemade schema parser to a proper AST parser (exploration has already be done, it is just a matter of implementation).
👉 This will be the 2.0 or 2.1.
And, finally a template engine (tbd) to give more control on the output, and possibly generate other format than markdown.
👉 This will be the 2.1 or 2.2.
from graphql-markdown.
Super excited for this! This would work really well with Nextra's Docs Theme
from graphql-markdown.
Related Issues (20)
- Add metadata to autogenerated docs HOT 2
- improve build chain HOT 1
- Typedoc improvements
- Compatibility with Docusaurus v3
- Upgrade website to Docusaurus v3
- Adjustments for Docusaurus v3 HOT 7
- Optional categories
- Custom Types (AWSDate, AWSDateTime) and graphql codegen Compatibility HOT 1
- Support generating pages in draft mode HOT 6
- COMMAND deprecated in Earthly 0.8
- Json File Loader - Introspection Query Input HOT 2
- Separate API from Types
- support examples
- Query descriptions not showing HOT 1
- Nested private types are shown in the examples HOT 3
- Enable relative paths HOT 4
- Doesnt work with npm dependency graphql 15.8.0 HOT 1
- Webpack 5 polyfills when implementing useDiff HOT 1
- Getting TypeError HOT 1
- Run in standalone mode and generate single file HOT 3
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from graphql-markdown.