diff --git a/changelog/overview.mdx b/changelog/overview.mdx index a1d431e..7b03d49 100644 --- a/changelog/overview.mdx +++ b/changelog/overview.mdx @@ -5,8 +5,17 @@ mode: "wide" --- +## Web Editor +We've revamped our web editor so that you can now update docs with a fully WYSIWYG experience, while syncing with markdown. + +Check out our [docs on getting started with Web Editor](/webeditor). + +## llms.txt +All docs instances are now automatically hosted at /llms.txt and /llms-full.txt so that LLMs can easily ingest your documentation. For more information, read the [docs on the new llms.txt standard.](https://llmstxt.org) + ## Localization You can now localize your docs which operates similarly to versioning. Add a `locale` to a version and fixed content in Mintlify like "Was this page helpful?" will also match the locale. + diff --git a/mint.json b/mint.json index 313f223..c3f2e4d 100644 --- a/mint.json +++ b/mint.json @@ -61,6 +61,7 @@ "pages": [ "quickstart", "development", + "webeditor", "settings/global", "settings/navigation", "migration" diff --git a/webeditor.mdx b/webeditor.mdx new file mode 100644 index 0000000..8026819 --- /dev/null +++ b/webeditor.mdx @@ -0,0 +1,58 @@ +--- +title: "Web Editor" +description: "Update docs with a WYSIWYG experience" +icon: 'pen-to-square' +--- +Web Editor allows you to create, update, and publish docs directly in Mintlify with a WYSIWYG (What You See Is What You Get) editor. + +All Mintlify components are available in the Web Editor with a slash command. + +## Git basics +While Web Editor means you don’t need to go to GitHub or your command line to make changes, it’s still helpful to know the basics of git. + +Git terminology: + +- **Repository**: A storage space where your code lives. It can be local (on your computer) or remote (like GitHub or GitLab). +- **Commit**: A snapshot of changes made to files in the repository. +- **Branch**: A separate line of development. It's a working copy of the code that allows you to work on changes without affecting the main version. +- **Pull request:** A request to merge changes from a working branch into the main branch. This is used for reviewing content before making changes live. + + The translation from Web Editor to git terminology is: + +- “Create a branch” = create a new branch +- “Save changes” = create a commit +- “Publish” = create a pull request (if you aren’t on the main branch) + +## How to create and publish an edit + +The general flow you’ll be following with Web Editor is: + + + + If you haven’t done so, set up your initial connection to your repository (see [Quickstart](https://mintlify.com/docs/quickstart)) + + + In the top left corner, click on the branch icon to create a new branch. + This will be your working branch to make changes. Give it a short but descriptive title, e.g. tiffany-adding-editor-page. + As a best practice, you should always create a new branch to make changes so you can submit a Pull Request for review by other teammates. You also may not have permissions to make changes to the main branch. + + + The “Changes” dropdown in the navigation bar keeps track of all the files you have changed in this working session. You can also discard changes with this dropdown. + + + If you want to save the changes you’ve made so far, click “Save changes,” which will create a commit.1. This saves a snapshot of your current work, including details of what was changed, as part of your working branch. You can revisit or undo these changes later if needed in GitHub. Once you “Save changes”, the “Changes” dropdown will reset. + + + When you are ready to submit your content for review, hitting “publish” in the top right corner will create a pull request for review by other teammates. Add a description of your changes to help expedite the review process. + + + +## Editing modes + +If at any point you are having difficulty making content edits, you can also switch into a different editing mode and edit the source file directly. + +In the navigation bar, there are three different options for viewing the Web Editor. + +- **Visual Editor**: This is the WYSIWYG experience to edit. It’ll show content exactly how it’ll appear in your final docs. +- **Source Editor**: This will show the file in markdown format. +- **Diff View:** This will show the differences between what you’re working on and the latest version that you have committed, in markdown format. The diff view will reset once you save changes or make a pull request. \ No newline at end of file