Skip to content

Conversation

@dichotommy
Copy link
Contributor

@dichotommy dichotommy commented Jan 31, 2021

Final to do before merging:

  • Fix all links (once paths are relatively set in stone)
  • Polish all README.md files
  • Style check

Future planned improvements (not in this PR):

  • Expand "Create" section with "Community Highlights" subsection
  • Write new step-by-step guides for installation and updating
  • Split "Field Properties" page in two (unique pages for Searchable Attributes and Displayed Attributes)
  • Write learning-oriented articles on Asynchronous APIs, RESTful paradigm, the strengths of prefix search (could go in Core Concepts or Advanced Topics)
  • Documentation homepage could be a good place to display patch notes of the most recent release

Would like feedback on:

  • Section + subsection names
  • Organization of content (does anything feel out of place?)
  • Missing content (was any information lost in the reorganization? Answer should be no)
  • All landing pages (index.md + all README.md files, accessed by clicking on a section or subsection)

Closes #634 , closes #619

@dichotommy
Copy link
Contributor Author

@curquiza Would you like to contribute an introduction paragraph for sdks.md?

In the preview, you can find this page by going to Learn -> What Is MeiliSearch -> SDKs

@dichotommy
Copy link
Contributor Author

dichotommy commented Jan 31, 2021

Note: Netlify preview appears to be having some problems, consider cloning the branch and doing a yarn dev if you want to poke around.

@curquiza
Copy link
Member

curquiza commented Feb 1, 2021

@curquiza Would you like to contribute an introduction paragraph for sdks.md?

hum, I like yours in "What is MeiliSearch?" main page ->

Our team and community have worked hard to bring MeiliSearch to almost all popular web development languages, frameworks, and deployment options—and new integrations are constantly in development.

Explanation of new documentation sections
Moved quick start guide and what's next into new Learn directory
Moved contents of /guides/main_concepts/ into /learn/core_concepts/
Moved /guides/introduction/README.md into /learn/learn_meilisearch/. Added some content.
Moved contents of resources/howtos/ into create/how_to/. Added content to that folder's README.md
Moved /references/* to /reference/api/
Moved several files from /guides/advanced_guides/ into /reference/under_the_hood/
Moved stop_words.md, datatypes.md, asynchronous_updates.md, and about_storage.md into reference/under_the_hood/
Move guides/advanced_guides/* to reference/features
Moved contact.md and sdks.md into learn/. Also deleted resources/tutorials/README.md and improved learn/learn_meilisearch/README.md
Made new dir learn/what_is_meilisearch/, moved sdks.md and comparison_to_alternatives.md there
Created new folder learn/elevate -- represents section tentatively titled Elevate Your Understanding, with clarifications on features such as dumps vs. snapshots, facets vs. filters, etc.
Create /learn/README.md and add 'What is MeiliSearch' to the Learn sidebar
Add Learn MeiliSearch, Core Concepts, and Elevate Your Understanding to the Learn sidebar. Improve learn/core_concepts/README.md
Create reference sidebar (categories: Feature References; API References; Under the Hood), create READMEs for /reference/, /reference/features/, /reference/under_the_hood
Add Create sidebar to config.js (only one section for the moment: How To), add /create/README.md
@dichotommy dichotommy marked this pull request as ready for review February 1, 2021 21:16
Copy link
Contributor

@fharper fharper left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That is some very good work there! Good job @react-learner

LGTM

@curquiza
Copy link
Member

curquiza commented Feb 2, 2021

You made an awesome job!! 😁

@dichotommy dichotommy merged commit 32d957b into master Feb 2, 2021
@dichotommy dichotommy deleted the restructure branch February 2, 2021 19:00
dichotommy added a commit that referenced this pull request Feb 2, 2021
@dichotommy dichotommy restored the restructure branch February 2, 2021 19:14
@dichotommy
Copy link
Contributor Author

This did not work, caused the same error as can be seen in the Netlify deploy preview. Strange, as there's no error with local VuePress builds. Must be something on Netlify's end, or else... the scraper? 🤔

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

Successfully merging this pull request may close these issues.

Documentation Restructure Proposal Tracker: Documentation Restructure

4 participants