Comments (8)
It looks like both the parser that creates the AST as well as the docs pages are custom implementations. Was this done to reduce deployment complexity (dependencies, reliance on 3rd party tools), or because no viable alternatives existed at that time?
from olddocumentationsite.
We did not find good stuff 3years ago but if you know something worth looking please let me know
from olddocumentationsite.
http://typedoc.org/ might be worth a try. What are special features provided by the custom implementation that may not be available in a generic solution?
from olddocumentationsite.
I expect that switching to typedoc would be a lot more involved than just tackling the issue in the current builder, as described in my comment in #713.
The current builder relies on the typescript-services
package for the AST which in turn has been marked as obsolete and had its last update in 2014. I suspect that switching to the new node API for the TypeScript parser should get rid of the ghost members/parameters, although the rendered markdown might need some fixing as well.
from olddocumentationsite.
Do you mind trying to move to the new API?
from olddocumentationsite.
Sooo ... typescript-services essentially uses a compiled TypeScript 1.0.0 (April 2014) where union types didn't even exist (at least the tests for those where added late 2014). In early 2015 TypeScript moved its compiler API around, and since then the compiler related APIs are no longer exposed to NodeJS.
There may be ways to patch typescript to reexpose them, but I'd argue that the time is better spent moving to TypeDoc and making it work for BabylonJS, especially given how much custom code in the builder currently relies on that dated API.
from olddocumentationsite.
whatever works :)
from olddocumentationsite.
Fixed with typedoc
from olddocumentationsite.
Related Issues (20)
- Match code style in Parametric Shapes tutorial to that of Playground example
- <SceneComponent /> should be <BabylonScene .../>? HOT 1
- Babylon 101 Video Tutorial Series HOT 1
- Dead links on the "Discover Basic Elements" tutorial page (Babylon101)
- Display first PG from the doc in the PG search
- Filter search for 'VR' should bring up WebXR docs HOT 4
- Arc Rotate Camera Contradiction in Docs HOT 1
- There are 89 broken links in the documentation site HOT 4
- Recreating the default configuration for the viewer has an error HOT 1
- Page not found errors on local version of Documentation HOT 2
- ArcRotationCamera.setTarget has different argument type than set target() HOT 4
- Animation blending PG in docs is broken HOT 1
- Missing info in https://doc.babylonjs.com/how_to/webxr_session_manage.
- "How to use Babylon.js with ReactJS" wrong links HOT 1
- 'jsut' Spelling mixed up issue on document doc.babylonjs.com/how_to/webxr_augmented_reality page HOT 2
- Incorrect method for customizing camera inputs HOT 2
- code in docs for Babylon React hook doesn't dispose scene on cleanup HOT 4
- SEO - Fail Doc Builds if missing Page metadata
- Clean Up Playground Namespaces HOT 1
- Turn NME doc page into an NME doc chapter HOT 1
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 olddocumentationsite.