Skip to content
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

Update version for release #168

Merged
merged 12 commits into from
Jul 22, 2021

Conversation

muneebahmed10
Copy link
Contributor

@muneebahmed10 muneebahmed10 commented Jul 22, 2021

Description:
Updates version number for release, and adds guards for C++ linkage. The /* *INDENT-OFF* */ is necessary for uncrustify. Also updates the documentation links to point to repositories/latest instead of specific releases, and adds a memory estimates table.

The documentation link for the CSDK points to the repository's README as it aggregates links for all releases. Since the FreeRTOS/FreeRTOS repository does not, the link here points to the latest hosted documentation on freertos.org

Also updates test/CMakeLists.txt so that tests can be built with newer C standards if specified on the command line

README.md Outdated
@@ -122,6 +122,13 @@ Please refer to the demos of the MQTT client library in the following locations

## Generating documentation

Note: For pre-generated documentation, please see the documentation linked in the above repositories:
Copy link
Contributor

Choose a reason for hiding this comment

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

It may be better to have the table under a different section than "Generating Documentation" as Abhijit had mentioned that the main concern is that it makes it misleading for customers about them having to generate documentation.

If the table is present in a separate section, like "Existing Documentation", toward the beginning of the README, it would be easier for customers to notice

Copy link
Contributor Author

Choose a reason for hiding this comment

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

How about this?

Documentation

Existing Documentation

Generating Documentation

Copy link
Contributor

Choose a reason for hiding this comment

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

Yes, that's fine. These can be moved before the Unit Tests section though to make it more prominent for customers to find

yourslab
yourslab previously approved these changes Jul 22, 2021
| Location |
| :-: |
| [AWS IoT Device SDK for Embedded C](https://github.com/aws/aws-iot-device-sdk-embedded-C#releases-and-documentation) |
| [FreeRTOS.org](https://freertos.org/Documentation/api-ref/coreMQTT/docs/doxygen/output/html/index.html) |
Copy link
Contributor

Choose a reason for hiding this comment

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

If the released versions of C-SDK and FreeRTOS.org don't match, it would be confusing to customers about the reason of their disparity. It would be important to add a note saying that it is possible for the C-SDK and FreeRTOS releases to contain different release versions of coreMQTT

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I added a note

yourslab
yourslab previously approved these changes Jul 22, 2021
README.md Outdated Show resolved Hide resolved
yourslab
yourslab previously approved these changes Jul 22, 2021
yourslab
yourslab previously approved these changes Jul 22, 2021
yourslab
yourslab previously approved these changes Jul 22, 2021
n9wxu
n9wxu previously approved these changes Jul 22, 2021
yourslab
yourslab previously approved these changes Jul 22, 2021
@muneebahmed10 muneebahmed10 dismissed stale reviews from yourslab and n9wxu via 6c506e4 July 22, 2021 21:18
@muneebahmed10 muneebahmed10 merged commit 51c8067 into FreeRTOS:main Jul 22, 2021
@muneebahmed10 muneebahmed10 deleted the update-for-release branch July 22, 2021 23:50
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.

4 participants