Skip to content

docs(Documentation): Update User Guide to Support June 2023 Release #683

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 40 commits into from
Aug 4, 2023

Conversation

Jake-Carter
Copy link
Contributor

@Jake-Carter Jake-Carter commented Jul 21, 2023

Pull Request Template

Description

This PR updates the MSDK User Guide. A preview of the new version can be viewed here: https://jake-carter.github.io/msdk/USERGUIDE/

Major changes:

  • Add support for the details PyMarkdown extension. The User Guide is now populated with helpful notes/warning dropdowns with improved formatting.
    image

  • Add documentation for headless/command-line installations (preview)

  • General formatting improvements with the addition of custom CSS

    • Code blocks are now surrounded by an outline:
      image
    • Tables (mostly) no longer stretch across the boundary of the page.
      image
  • Update Tables for Build Config Variables (preview)

    • Missing variables have been documented
    • Table have been further organized into sub-sections
  • Add documentation on VS Code Disassembly View (preview)

  • Add setenv.sh as an option for Command-Line setup instructions (preview)

  • Document make targets for flashing (make flash.openocd) (preview)

  • Fix typo in BSP Search Directory code example (preview)

  • Add auto-generated tables of examples for all microcontrollers (preview)

  • Add MAX32662 web links now that part is released.

  • Add CoreMark library section (preview)

  • Add Debugger documentation (preview)

    • Hardware limitations of debug
    • MAX32625PICO documentation, firmware updates, and erase instructions

Checklist Before Requesting Review

  • PR Title follows correct guidelines.
  • Description of changes and all other relevant information.
  • (Optional) Link any related GitHub issues using a keyword
  • (Optional) Provide info on any relevant functional testing/validation. For API changes or significant features, this is not optional.

@Jake-Carter Jake-Carter added the documentation Improvements or additions to documentation label Jul 21, 2023
@github-actions github-actions bot added MAX32672 Related to the MAX32672 (ME21) MAX32675 Related to the MAX32675 (ME16) MAX32680 Related to the MAX32680 (ME20) MAX32690 Related to the MAX32690 (ME18) MAX78000 Related to the MAX78000 (AI85) MAX78002 Related to the MAX78002 (AI87) BLE Related to Bluetooth MAX32662 Related to the MAX32662 (ME12) labels Jul 26, 2023
@github-actions github-actions bot added the Workflow Related to Workflow development label Jul 26, 2023
@github-actions github-actions bot removed the Workflow Related to Workflow development label Jul 27, 2023
@Jake-Carter
Copy link
Contributor Author

Examples section has been updated with "Common Examples" vs part-specific examples (preview)

@@ -33,7 +33,7 @@

/**
* @file main.c
* @brief Demo
* @brief This example demonstrates the use of the TFT Display, UART Terminal, RTC, Pushbuttons, and LEDs on the MAX32662EVKIT.
Copy link
Contributor

Choose a reason for hiding this comment

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

MAX32662EVKIT gets added in the common examples.
image

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fixed 83fdfed

@sihyung-maxim
Copy link
Contributor

Should we leave the ME55 in the common examples? These examples specifically are untested and must be updated when we start the bring-up.
image

@Jake-Carter
Copy link
Contributor Author

Should we leave the ME55 in the common examples? These examples specifically are untested and must be updated when we start the bring-up. image

Thanks, blacklisted the MAX32572. 66c25f7

@Jake-Carter Jake-Carter merged commit 21963b2 into analogdevicesinc:main Aug 4, 2023
@Jake-Carter Jake-Carter deleted the dev/ug branch August 4, 2023 17:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
BLE Related to Bluetooth documentation Improvements or additions to documentation MAX32520 Related to the MAX32520 (ES17) MAX32650 Related to the MAX32650 (ME10) MAX32655 Related to the MAX32655 (ME17) MAX32660 Related to the MAX32660 (ME11) MAX32662 Related to the MAX32662 (ME12) MAX32665 Related to the MAX32665 (ME14) MAX32670 Related to the MAX32670 (ME15) MAX32672 Related to the MAX32672 (ME21) MAX32675 Related to the MAX32675 (ME16) MAX32680 Related to the MAX32680 (ME20) MAX32690 Related to the MAX32690 (ME18) MAX78000 Related to the MAX78000 (AI85) MAX78002 Related to the MAX78002 (AI87)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants