From 2dc63e4333564e8046a50b9336a4f7eea8cfc385 Mon Sep 17 00:00:00 2001 From: Dion Hulse Date: Thu, 29 Nov 2018 18:58:06 +1100 Subject: [PATCH 1/9] Fix README filename --- docs/root-manifest.json | 4 ++-- docs/toc.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/root-manifest.json b/docs/root-manifest.json index 784008dd17bb50..03652d36151853 100644 --- a/docs/root-manifest.json +++ b/docs/root-manifest.json @@ -7,8 +7,8 @@ }, { "title": "Designer & Developer Handbook", - "slug": "designers-developers", - "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/README.md", + "slug": "readme", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/readme.md", "parent": null }, { diff --git a/docs/toc.json b/docs/toc.json index d519837b89a8a8..4bc496cee94afe 100644 --- a/docs/toc.json +++ b/docs/toc.json @@ -1,6 +1,6 @@ [ {"docs/readme.md": []}, - {"docs/designers-developers/README.md": [ + {"docs/designers-developers/readme.md": [ {"docs/designers-developers/key-concepts.md": []}, {"docs/designers-developers/developers/README.md": [ {"docs/designers-developers/developers/block-api/README.md": [ From 81f621f213c8a7a6bf4239ead5e9b0a2ebc9ab98 Mon Sep 17 00:00:00 2001 From: Dion Hulse Date: Thu, 29 Nov 2018 19:00:38 +1100 Subject: [PATCH 2/9] Fix filename --- docs/manifest.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/manifest.json b/docs/manifest.json index c461c5d3b9a361..02f16da54a8f0c 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -8,7 +8,7 @@ { "title": "Designer & Developer Handbook", "slug": "designers-developers", - "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/README.md", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/readme.md", "parent": null }, { From 2cdf5cba6acd8c2788e382cab37806ae8034a3cf Mon Sep 17 00:00:00 2001 From: Dion Hulse Date: Thu, 29 Nov 2018 19:20:39 +1100 Subject: [PATCH 3/9] Add the Contributors handbook to the TOC --- docs/toc.json | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/docs/toc.json b/docs/toc.json index 4bc496cee94afe..b9f723a91ab54d 100644 --- a/docs/toc.json +++ b/docs/toc.json @@ -34,5 +34,26 @@ ]}, {"docs/designers-developers/glossary.md": []}, {"docs/designers-developers/faq.md": []} + ]}, + {"docs/contributors/readme.md": [ + {"docs/contributors/coding-guidelines.md": []}, + {"docs/contributors/copy-guide.md": []}, + {"docs/contributors/design.md": []}, + {"docs/contributors/grammar.md": []}, + {"docs/contributors/history.md": []}, + {"docs/contributors/outreach.md": [ + {"docs/contributors/outreach/articles.md": []}, + {"docs/contributors/outreach/meetups.md": []}, + {"docs/contributors/outreach/resources.md": []}, + {"docs/contributors/outreach/talks.md": []} + ]}, + {"docs/contributors/principles.md": [ + {"docs/contributors/principles/the-block.md": []} + ]}, + {"docs/contributors/reference.md": []}, + {"docs/contributors/release.md": []}, + {"docs/contributors/repository-management.md": []}, + {"docs/contributors/scripts.md": []}, + {"docs/contributors/testing-overview.md": []} ]} ] From 40774e3e3d00282d33c3b8bc7e4ba25cbe4e0586 Mon Sep 17 00:00:00 2001 From: Dion Hulse Date: Thu, 29 Nov 2018 19:21:34 +1100 Subject: [PATCH 4/9] Rebuild the root manifest with the additional Contributors handbook in the TOC --- docs/root-manifest.json | 112 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 110 insertions(+), 2 deletions(-) diff --git a/docs/root-manifest.json b/docs/root-manifest.json index 03652d36151853..17f72a4e8d738e 100644 --- a/docs/root-manifest.json +++ b/docs/root-manifest.json @@ -1,13 +1,13 @@ [ { "title": "Gutenberg Handbook", - "slug": "readme", + "slug": "docs", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/readme.md", "parent": null }, { "title": "Designer & Developer Handbook", - "slug": "readme", + "slug": "designers-developers", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/readme.md", "parent": null }, @@ -172,5 +172,113 @@ "slug": "faq", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/faq.md", "parent": "designers-developers" + }, + { + "title": "Contributors", + "slug": "contributors", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/readme.md", + "parent": null + }, + { + "title": "Coding Guidelines", + "slug": "coding-guidelines", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/coding-guidelines.md", + "parent": "contributors" + }, + { + "title": "Gutencopy Guidelines", + "slug": "copy-guide", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/copy-guide.md", + "parent": "contributors" + }, + { + "title": "Gutenberg Design Principles & Vision", + "slug": "design", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/design.md", + "parent": "contributors" + }, + { + "title": "The Gutenberg block grammar", + "slug": "grammar", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/grammar.md", + "parent": "contributors" + }, + { + "title": "History", + "slug": "history", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/history.md", + "parent": "contributors" + }, + { + "title": "Outreach", + "slug": "outreach", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/outreach.md", + "parent": "contributors" + }, + { + "title": "Articles", + "slug": "articles", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/outreach\/articles.md", + "parent": "contributors\/outreach" + }, + { + "title": "Meetups", + "slug": "meetups", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/outreach\/meetups.md", + "parent": "contributors\/outreach" + }, + { + "title": "Resources", + "slug": "resources", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/outreach\/resources.md", + "parent": "contributors\/outreach" + }, + { + "title": "Talks", + "slug": "talks", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/outreach\/talks.md", + "parent": "contributors\/outreach" + }, + { + "title": "Principles", + "slug": "principles", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/principles.md", + "parent": "contributors" + }, + { + "title": "Blocks are the Interface", + "slug": "the-block", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/principles\/the-block.md", + "parent": "contributors\/principles" + }, + { + "title": "Reference", + "slug": "reference", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/reference.md", + "parent": "contributors" + }, + { + "title": "Gutenberg Release Process", + "slug": "release", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/release.md", + "parent": "contributors" + }, + { + "title": "Repository Management", + "slug": "repository-management", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/repository-management.md", + "parent": "contributors" + }, + { + "title": "Scripts", + "slug": "scripts", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/scripts.md", + "parent": "contributors" + }, + { + "title": "Testing Overview", + "slug": "testing-overview", + "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/testing-overview.md", + "parent": "contributors" } ] \ No newline at end of file From e258e2acebf61eb560517c2938aef2e619ea98f3 Mon Sep 17 00:00:00 2001 From: Dion Hulse Date: Thu, 29 Nov 2018 19:22:12 +1100 Subject: [PATCH 5/9] Rebuild the manifest file with the contributors --- docs/manifest.json | 110 ++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 109 insertions(+), 1 deletion(-) diff --git a/docs/manifest.json b/docs/manifest.json index 02f16da54a8f0c..4010832b0d51b9 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -1,7 +1,7 @@ [ { "title": "Gutenberg Handbook", - "slug": "readme", + "slug": "docs", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/readme.md", "parent": null }, @@ -173,6 +173,114 @@ "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/faq.md", "parent": "designers-developers" }, + { + "title": "Contributors", + "slug": "contributors", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/readme.md", + "parent": null + }, + { + "title": "Coding Guidelines", + "slug": "coding-guidelines", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/coding-guidelines.md", + "parent": "contributors" + }, + { + "title": "Gutencopy Guidelines", + "slug": "copy-guide", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/copy-guide.md", + "parent": "contributors" + }, + { + "title": "Gutenberg Design Principles & Vision", + "slug": "design", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/design.md", + "parent": "contributors" + }, + { + "title": "The Gutenberg block grammar", + "slug": "grammar", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/grammar.md", + "parent": "contributors" + }, + { + "title": "History", + "slug": "history", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/history.md", + "parent": "contributors" + }, + { + "title": "Outreach", + "slug": "outreach", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/outreach.md", + "parent": "contributors" + }, + { + "title": "Articles", + "slug": "articles", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/outreach/articles.md", + "parent": "contributors/outreach" + }, + { + "title": "Meetups", + "slug": "meetups", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/outreach/meetups.md", + "parent": "contributors/outreach" + }, + { + "title": "Resources", + "slug": "resources", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/outreach/resources.md", + "parent": "contributors/outreach" + }, + { + "title": "Talks", + "slug": "talks", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/outreach/talks.md", + "parent": "contributors/outreach" + }, + { + "title": "Principles", + "slug": "principles", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/principles.md", + "parent": "contributors" + }, + { + "title": "Blocks are the Interface", + "slug": "the-block", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/principles/the-block.md", + "parent": "contributors/principles" + }, + { + "title": "Reference", + "slug": "reference", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/reference.md", + "parent": "contributors" + }, + { + "title": "Gutenberg Release Process", + "slug": "release", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/release.md", + "parent": "contributors" + }, + { + "title": "Repository Management", + "slug": "repository-management", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/repository-management.md", + "parent": "contributors" + }, + { + "title": "Scripts", + "slug": "scripts", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/scripts.md", + "parent": "contributors" + }, + { + "title": "Testing Overview", + "slug": "testing-overview", + "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/testing-overview.md", + "parent": "contributors" + }, { "title": "Packages", "slug": "packages", From 30693876ef80db503244549de0b2479b5a2d5448 Mon Sep 17 00:00:00 2001 From: Dion Hulse Date: Thu, 29 Nov 2018 19:23:44 +1100 Subject: [PATCH 6/9] Rebuild the manifest file without paths in the 'parent' field as the Importer can't handle that. --- docs/manifest.json | 54 ++++++++++++++++++++--------------------- docs/root-manifest.json | 54 ++++++++++++++++++++--------------------- 2 files changed, 54 insertions(+), 54 deletions(-) diff --git a/docs/manifest.json b/docs/manifest.json index 4010832b0d51b9..1f0eb184d214f7 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -27,115 +27,115 @@ "title": "Block API Reference", "slug": "block-api", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/block-api/README.md", - "parent": "designers-developers/developers" + "parent": "developers" }, { "title": "Block Registration ", "slug": "block-registration", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/block-api/block-registration.md", - "parent": "designers-developers/developers/block-api" + "parent": "block-api" }, { "title": "Edit and Save", "slug": "block-edit-save", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/block-api/block-edit-save.md", - "parent": "designers-developers/developers/block-api" + "parent": "block-api" }, { "title": "Attributes", "slug": "block-attributes", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/block-api/block-attributes.md", - "parent": "designers-developers/developers/block-api" + "parent": "block-api" }, { "title": "Deprecated Blocks", "slug": "block-deprecation", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/block-api/block-deprecation.md", - "parent": "designers-developers/developers/block-api" + "parent": "block-api" }, { "title": "Templates", "slug": "block-templates", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/block-api/block-templates.md", - "parent": "designers-developers/developers/block-api" + "parent": "block-api" }, { "title": "Annotations", "slug": "block-annotations", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/block-api/block-annotations.md", - "parent": "designers-developers/developers/block-api" + "parent": "block-api" }, { "title": "Filter Reference", "slug": "filters", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/filters/README.md", - "parent": "designers-developers/developers" + "parent": "developers" }, { "title": "Block Filters", "slug": "block-filters", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/filters/block-filters.md", - "parent": "designers-developers/developers/filters" + "parent": "filters" }, { "title": "Editor Filters (Experimental)", "slug": "editor-filters", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/filters/editor-filters.md", - "parent": "designers-developers/developers/filters" + "parent": "filters" }, { "title": "Parser Filters", "slug": "parser-filters", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/filters/parser-filters.md", - "parent": "designers-developers/developers/filters" + "parent": "filters" }, { "title": "Autocomplete", "slug": "autocomplete-filters", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/filters/autocomplete-filters.md", - "parent": "designers-developers/developers/filters" + "parent": "filters" }, { "title": "Data Module Reference", "slug": "data", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/data/README.md", - "parent": "designers-developers/developers" + "parent": "developers" }, { "title": "Packages", "slug": "packages", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/packages.md", - "parent": "designers-developers/developers" + "parent": "developers" }, { "title": "Theming for Gutenberg", "slug": "themes", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/themes/README.md", - "parent": "designers-developers/developers" + "parent": "developers" }, { "title": "Theme Support", "slug": "theme-support", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/themes/theme-support.md", - "parent": "designers-developers/developers/themes" + "parent": "themes" }, { "title": "Backwards Compatibility", "slug": "backwards-compatibility", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/backwards-compatibility/README.md", - "parent": "designers-developers/developers" + "parent": "developers" }, { "title": "Deprecations", "slug": "deprecations", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/backwards-compatibility/deprecations.md", - "parent": "designers-developers/developers/backwards-compatibility" + "parent": "backwards-compatibility" }, { "title": "Meta Boxes", "slug": "meta-box", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/developers/backwards-compatibility/meta-box.md", - "parent": "designers-developers/developers/backwards-compatibility" + "parent": "backwards-compatibility" }, { "title": "Designer Documentation", @@ -147,19 +147,19 @@ "title": "Block Design", "slug": "block-design", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/designers/block-design.md", - "parent": "designers-developers/designers" + "parent": "designers" }, { "title": "Patterns", "slug": "design-patterns", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/designers/design-patterns.md", - "parent": "designers-developers/designers" + "parent": "designers" }, { "title": "Resources", "slug": "design-resources", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/designers-developers/designers/design-resources.md", - "parent": "designers-developers/designers" + "parent": "designers" }, { "title": "Glossary", @@ -219,25 +219,25 @@ "title": "Articles", "slug": "articles", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/outreach/articles.md", - "parent": "contributors/outreach" + "parent": "outreach" }, { "title": "Meetups", "slug": "meetups", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/outreach/meetups.md", - "parent": "contributors/outreach" + "parent": "outreach" }, { "title": "Resources", "slug": "resources", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/outreach/resources.md", - "parent": "contributors/outreach" + "parent": "outreach" }, { "title": "Talks", "slug": "talks", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/outreach/talks.md", - "parent": "contributors/outreach" + "parent": "outreach" }, { "title": "Principles", @@ -249,7 +249,7 @@ "title": "Blocks are the Interface", "slug": "the-block", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/contributors/principles/the-block.md", - "parent": "contributors/principles" + "parent": "principles" }, { "title": "Reference", diff --git a/docs/root-manifest.json b/docs/root-manifest.json index 17f72a4e8d738e..c4f89e9db9bcd8 100644 --- a/docs/root-manifest.json +++ b/docs/root-manifest.json @@ -27,115 +27,115 @@ "title": "Block API Reference", "slug": "block-api", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/block-api\/README.md", - "parent": "designers-developers\/developers" + "parent": "developers" }, { "title": "Block Registration ", "slug": "block-registration", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/block-api\/block-registration.md", - "parent": "designers-developers\/developers\/block-api" + "parent": "block-api" }, { "title": "Edit and Save", "slug": "block-edit-save", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/block-api\/block-edit-save.md", - "parent": "designers-developers\/developers\/block-api" + "parent": "block-api" }, { "title": "Attributes", "slug": "block-attributes", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/block-api\/block-attributes.md", - "parent": "designers-developers\/developers\/block-api" + "parent": "block-api" }, { "title": "Deprecated Blocks", "slug": "block-deprecation", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/block-api\/block-deprecation.md", - "parent": "designers-developers\/developers\/block-api" + "parent": "block-api" }, { "title": "Templates", "slug": "block-templates", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/block-api\/block-templates.md", - "parent": "designers-developers\/developers\/block-api" + "parent": "block-api" }, { "title": "Annotations", "slug": "block-annotations", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/block-api\/block-annotations.md", - "parent": "designers-developers\/developers\/block-api" + "parent": "block-api" }, { "title": "Filter Reference", "slug": "filters", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/filters\/README.md", - "parent": "designers-developers\/developers" + "parent": "developers" }, { "title": "Block Filters", "slug": "block-filters", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/filters\/block-filters.md", - "parent": "designers-developers\/developers\/filters" + "parent": "filters" }, { "title": "Editor Filters (Experimental)", "slug": "editor-filters", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/filters\/editor-filters.md", - "parent": "designers-developers\/developers\/filters" + "parent": "filters" }, { "title": "Parser Filters", "slug": "parser-filters", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/filters\/parser-filters.md", - "parent": "designers-developers\/developers\/filters" + "parent": "filters" }, { "title": "Autocomplete", "slug": "autocomplete-filters", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/filters\/autocomplete-filters.md", - "parent": "designers-developers\/developers\/filters" + "parent": "filters" }, { "title": "Data Module Reference", "slug": "data", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/data\/README.md", - "parent": "designers-developers\/developers" + "parent": "developers" }, { "title": "Packages", "slug": "packages", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/packages.md", - "parent": "designers-developers\/developers" + "parent": "developers" }, { "title": "Theming for Gutenberg", "slug": "themes", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/themes\/README.md", - "parent": "designers-developers\/developers" + "parent": "developers" }, { "title": "Theme Support", "slug": "theme-support", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/themes\/theme-support.md", - "parent": "designers-developers\/developers\/themes" + "parent": "themes" }, { "title": "Backwards Compatibility", "slug": "backwards-compatibility", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/backwards-compatibility\/README.md", - "parent": "designers-developers\/developers" + "parent": "developers" }, { "title": "Deprecations", "slug": "deprecations", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/backwards-compatibility\/deprecations.md", - "parent": "designers-developers\/developers\/backwards-compatibility" + "parent": "backwards-compatibility" }, { "title": "Meta Boxes", "slug": "meta-box", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/developers\/backwards-compatibility\/meta-box.md", - "parent": "designers-developers\/developers\/backwards-compatibility" + "parent": "backwards-compatibility" }, { "title": "Designer Documentation", @@ -147,19 +147,19 @@ "title": "Block Design", "slug": "block-design", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/designers\/block-design.md", - "parent": "designers-developers\/designers" + "parent": "designers" }, { "title": "Patterns", "slug": "design-patterns", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/designers\/design-patterns.md", - "parent": "designers-developers\/designers" + "parent": "designers" }, { "title": "Resources", "slug": "design-resources", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/designers-developers\/designers\/design-resources.md", - "parent": "designers-developers\/designers" + "parent": "designers" }, { "title": "Glossary", @@ -219,25 +219,25 @@ "title": "Articles", "slug": "articles", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/outreach\/articles.md", - "parent": "contributors\/outreach" + "parent": "outreach" }, { "title": "Meetups", "slug": "meetups", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/outreach\/meetups.md", - "parent": "contributors\/outreach" + "parent": "outreach" }, { "title": "Resources", "slug": "resources", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/outreach\/resources.md", - "parent": "contributors\/outreach" + "parent": "outreach" }, { "title": "Talks", "slug": "talks", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/outreach\/talks.md", - "parent": "contributors\/outreach" + "parent": "outreach" }, { "title": "Principles", @@ -249,7 +249,7 @@ "title": "Blocks are the Interface", "slug": "the-block", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/contributors\/principles\/the-block.md", - "parent": "contributors\/principles" + "parent": "principles" }, { "title": "Reference", From 32d49acaa3d0fb08abf714181ae924eb9bb1baa9 Mon Sep 17 00:00:00 2001 From: Dion Hulse Date: Thu, 29 Nov 2018 19:37:56 +1100 Subject: [PATCH 7/9] Correct the slug of the root-level index --- docs/manifest.json | 2 +- docs/root-manifest.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/manifest.json b/docs/manifest.json index 1f0eb184d214f7..a15c102355f36c 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -1,7 +1,7 @@ [ { "title": "Gutenberg Handbook", - "slug": "docs", + "slug": "handbook", "markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/docs/readme.md", "parent": null }, diff --git a/docs/root-manifest.json b/docs/root-manifest.json index c4f89e9db9bcd8..0d8c79653cf331 100644 --- a/docs/root-manifest.json +++ b/docs/root-manifest.json @@ -1,7 +1,7 @@ [ { "title": "Gutenberg Handbook", - "slug": "docs", + "slug": "handbook", "markdown_source": "https:\/\/raw.githubusercontent.com\/WordPress\/gutenberg\/master\/docs\/readme.md", "parent": null }, From 424d5def87dab2225f44cc90bd03c5ac7fcc4bc6 Mon Sep 17 00:00:00 2001 From: Dion Hulse Date: Thu, 29 Nov 2018 19:41:51 +1100 Subject: [PATCH 8/9] DEBUG: This is the tool I used to re-generate the root-manifest file, altered slightly from https://github.com/WordPress/gutenberg/pull/11817/commits/a0a6349feac0be389070e36483da08481b5d17e0 --- docs/generate.php | 119 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 119 insertions(+) create mode 100644 docs/generate.php diff --git a/docs/generate.php b/docs/generate.php new file mode 100644 index 00000000000000..f02531d9cdf7a1 --- /dev/null +++ b/docs/generate.php @@ -0,0 +1,119 @@ + $child) { + foreach ($child as $file => $children) { + // Build an absolute path to the file + $path = __DIR__ . '/../' . $file; + // Append to the manifest + $title = getTitle(file_get_contents($path)); + if ( ! $title ) { + $title = ucwords( basename( $path ) ); + if ( 'Readme.md' == $title ) { + $title = ucwords( basename( dirname( $path ) ) ); + } + } + $manifest[] = [ + 'title' => $title, + 'slug' => getSlug($file), + 'markdown_source' => sprintf('https://raw.githubusercontent.com/WordPress/gutenberg/master/%s', $file), + 'parent' => getParent($path), + ]; + // Run the process for children items + if (!empty($children) && is_array($children)) { + $additions = process($children); + // Merge the children into the containing manifest + $manifest = array_merge($manifest, $additions); + } + if (is_string($children)) { + // @todo + // The TOC.json format includes tokens that could be replaced + // in the future, for easily embedding auto-generated content + // into the overall manifest. + } + } + } + return $manifest; +} + // Decode the TOC JSON +$contents = json_decode(file_get_contents(__DIR__ . '/toc.json'), true); + // Process the contents +$response = process($contents); + // Push out to root-manifest.json +file_put_contents(__DIR__ . '/root-manifest.json', json_encode($response, JSON_PRETTY_PRINT)); From 7dddeaba01ae404ed4bd7803f596d8405ed5c814 Mon Sep 17 00:00:00 2001 From: Dion Hulse Date: Thu, 29 Nov 2018 19:42:40 +1100 Subject: [PATCH 9/9] Remove generate.php tool from PR --- docs/generate.php | 119 ---------------------------------------------- 1 file changed, 119 deletions(-) delete mode 100644 docs/generate.php diff --git a/docs/generate.php b/docs/generate.php deleted file mode 100644 index f02531d9cdf7a1..00000000000000 --- a/docs/generate.php +++ /dev/null @@ -1,119 +0,0 @@ - $child) { - foreach ($child as $file => $children) { - // Build an absolute path to the file - $path = __DIR__ . '/../' . $file; - // Append to the manifest - $title = getTitle(file_get_contents($path)); - if ( ! $title ) { - $title = ucwords( basename( $path ) ); - if ( 'Readme.md' == $title ) { - $title = ucwords( basename( dirname( $path ) ) ); - } - } - $manifest[] = [ - 'title' => $title, - 'slug' => getSlug($file), - 'markdown_source' => sprintf('https://raw.githubusercontent.com/WordPress/gutenberg/master/%s', $file), - 'parent' => getParent($path), - ]; - // Run the process for children items - if (!empty($children) && is_array($children)) { - $additions = process($children); - // Merge the children into the containing manifest - $manifest = array_merge($manifest, $additions); - } - if (is_string($children)) { - // @todo - // The TOC.json format includes tokens that could be replaced - // in the future, for easily embedding auto-generated content - // into the overall manifest. - } - } - } - return $manifest; -} - // Decode the TOC JSON -$contents = json_decode(file_get_contents(__DIR__ . '/toc.json'), true); - // Process the contents -$response = process($contents); - // Push out to root-manifest.json -file_put_contents(__DIR__ . '/root-manifest.json', json_encode($response, JSON_PRETTY_PRINT));