Skip to content

Conversation

josefaidt
Copy link
Contributor

@josefaidt josefaidt commented Feb 24, 2024

Description of changes:

In an effort to align authoring styles for code snippets and general Markdown across MDX pages, this PR adds a few plugins and tweaks the ESLint configuration to extend to linting markdown/mdx files and their code snippets.

  • adds @typescript-eslint/parser
  • adds eslint-plugin-mdx
  • applies special rules to mdx files in eslint overrides
  • adds remark-lint and supporting plugins, presets
  • adds remarklint settings to not clash with prettier and eslint-plugin-mdx per docs
  • enables eslint in VSCode settings with validation for MDX files
  • removes *.mdx from prettierignore
  • adds lint:content command since next lint does not support additional file extensions

Todo

  • fix lint errors
  • ensure ts parser services are not required for other types of snippets
  • ensure remark-lint is able to parse/recognize internal links

Related GitHub issue #, if available:

Instructions

If this PR should not be merged upon approval for any reason, please submit as a DRAFT

Which product(s) are affected by this PR (if applicable)?

  • amplify-cli
  • amplify-ui
  • amplify-studio
  • amplify-hosting
  • amplify-libraries

Which platform(s) are affected by this PR (if applicable)?

  • JS
  • Swift
  • Android
  • Flutter
  • React Native

Please add the product(s)/platform(s) affected to the PR title

Checks

  • Does this PR conform to the styleguide?

  • Does this PR include filetypes other than markdown or images? Please add or update unit tests accordingly.

  • Are any files being deleted with this PR? If so, have the needed redirects been created?

  • Are all links in MDX files using the MDX link syntax rather than HTML link syntax?

    ref: MDX: [link](https://docs.amplify.aws/)
    HTML: <a href="https://docs.amplify.aws/">link</a>

When this PR is ready to merge, please check the box below

  • Ready to merge

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

hibler13 and others added 15 commits February 19, 2024 13:21
* Updates to Vite + React quickstart

* Update src/fragments/gen2/quickstart/build-a-backend.mdx

Co-authored-by: Kevin Old <kevold@amazon.com>

* Update build-a-backend.mdx

* Update build-a-backend.mdx

* Update build-a-backend.mdx

---------

Co-authored-by: Kevin Old <kevold@amazon.com>
)

* platform typed as optional

* refactor init

* remove commented code

* remove angry useEffect

* fix typing

* added layoutcontext so mobile menu closes on navigation

* move import

---------

Co-authored-by: katiegoines <katiegoines@gmail.com>
…atform (aws-amplify#6947)

Co-authored-by: Tim Nguyen <54393192+timngyn@users.noreply.github.com>
…mplify#6954)

* chore: more layout refactoring

* remove unused prop, alphabetize props
@josefaidt josefaidt requested a review from a team as a code owner February 24, 2024 00:18
josefaidt and others added 14 commits February 23, 2024 16:19
* include usage for multi-page apps

* improve multi-page app docs

* use Hub syntax

* update imports in examples
* chore: Clean up broken Amplify JS API reference links.

* Cleaned up language.
* update build image settings for Gen 2

* remove callout and add fragment to vite guide
* chore: add unit test for YoutubeEmbed component

* add code coverage stats

---------

Co-authored-by: katiegoines <katiegoines@gmail.com>
* chore: add unit tests for Accordion component

* issue with window properties

* fixed tracking test

* working on animation issue

* accordion tests

* fix testing errors

* added test for closing accordion

* add code coverage stats

---------

Co-authored-by: katiegoines <katiegoines@gmail.com>
* Add algolia env vars to next.config

* Remove extra code string
…; add build step to docs (aws-amplify#6970)

* fix(data): update React Native minimum iOS deployment target; add build step to docs

* address PR feedback

* remove deployment target guidance

* add React Native version deployment target callout

* fix unrecognized syntax

* replace callout with accordion

* move 'upgrading' callout
katieklein and others added 16 commits March 14, 2024 19:07
* chore: add unit tests for MigrationAlert component

* chore: add unit tests for MigrationAlert component

---------

Co-authored-by: katiegoines <katiegoines@gmail.com>
Co-authored-by: katiegoines <katiegoines@gmail.com>
Co-authored-by: katiegoines <katiegoines@gmail.com>
* chore: add unit test for CLICommands

* chore: add unit test for Columns

* Update Command.test.tsx

triggering checks

---------

Co-authored-by: katiegoines <katiegoines@gmail.com>
* Update relative urls

* Update url
* Updating link checker to account for duplicate urls from different pages and link text

* Update slack formatting

* Remove console.log

* Add comments to function

* Remove extra console.logs()
* update redirects

* updated redirects

---------

Co-authored-by: katiegoines <katiegoines@gmail.com>
* fix(v5): update aws-amplify v5 dependency

* chore: remove extra '0' number from versions

* chore: remove vue2 block

* chore: update version reference
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
amplify/docs-engineering Issues with the docs site itself, NOT its content
Projects
None yet
Development

Successfully merging this pull request may close these issues.