Comments (2)
There is some ongoing conversation about where we should put the files. Some of the options discussed include:
- Put the markdown files in a directory structure that maps to the existing category hierarchy
- Put the markdown files in a "shallow" version of the category hierarchy (i.e. all files in a directory for the top-level category)
- Put the markdown files in a completely flat directory structure (all in one or two directories)
The trade-off of a rigid system (like the first option) is that it's easier for contributors to find files to edit, but it's less flexible for where to put them.
Whatever we decide to do, we will always be flexible post-migration. Our setup in Gatsby doesn't really care where the files live within the markdown-pages
directory.
We are planning on talking about this during our Monday sync and may schedule a follow-up meeting.
from docs-website.
Upon further review, this seems like a duplicate of #11
from docs-website.
Related Issues (20)
- Fix incorrect description of event flow behavior HOT 11
- Summarize your docs request HOT 2
- Issue: NRQL syntax, clauses, and functions HOT 2
- Microsoft Teams example ist not uptodate HOT 2
- Lack of NPM prerequisites and installation procedures HOT 2
- Metric prefix is not correct HOT 3
- Broken links in the Synthetics New Runtime Transition page HOT 1
- Summarize your docs request HOT 4
- Infra agent log intergration document hase logtype examples that are not present in the log parsing docs. HOT 3
- Need to update the page since the Azure UI is changed HOT 2
- Null check shall be added in the example of MS Teams notification template. HOT 4
- Mismatch between Entity Health Status Colors in Documentation and Platform HOT 2
- Links to MSI not working HOT 2
- Missing code highlighting on Azure documentation HOT 2
- Include docs around entity expiration time HOT 5
- This is a bug! Please fix! HOT 2
- This is an enhancement request! HOT 2
- Issue: 404 HOT 2
- Issue: 404 HOT 1
- Issue: 404 when trying to get info on data type `targetType` HOT 4
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 docs-website.