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

SDK: Improve All Examples Documentation #29560

Open
Tracked by #30943
rjvelazco opened this issue Aug 13, 2024 · 1 comment
Open
Tracked by #30943

SDK: Improve All Examples Documentation #29560

rjvelazco opened this issue Aug 13, 2024 · 1 comment

Comments

@rjvelazco
Copy link
Contributor

rjvelazco commented Aug 13, 2024

Parent Issue

#30943

Task

As a developer using the NextJS Example, I want the documentation to be clear, comprehensive, and easy to follow, so that I can effectively use and modify the example to suit my needs.

Proposed Objective

Technical User Experience

Proposed Priority

Priority 3 - Average

Acceptance Criteria

  1. Update README:
    • Provide a clear and concise introduction explaining how the example works with NextJS and DotCMS.
    • Clearly state any dependencies or prerequisites needed to use the example.
    • Ensure the README covers the GraphQL integration.

External Links... Slack Conversations, Support Tickets, Figma Designs, etc.

No response

Assumptions & Initiation Needs

Here is a list of the most important JSDoc annotations:

  • @param - Documents the parameters of a function.
  • @returns or @return - Documents the return value of a function.
  • @typedef - Defines custom types.
  • @property - Documents properties of an object.
  • @example - Provides example usage of the function or method.
  • @throws - Documents the exceptions that a function might throw.
  • @deprecated - Marks a function or method as deprecated.
  • @see - Provides a reference to related information.
  • @async - Indicates that a function is asynchronous.
  • @callback - Documents a callback function.

Quality Assurance Notes & Workarounds

  • Ensure that the documentation is consistent and follows a uniform style.
  • Include practical examples and use cases in the README to help developers understand how the example works.
  • Review and test the documentation to ensure accuracy and completeness.

Sub-Tasks & Estimates

No response

@rjvelazco rjvelazco moved this from New to Gardening Day Backlog in dotCMS - Product Planning Aug 13, 2024
@fmontes fmontes changed the title SDK: Improve NextJS Example Documentation SDK: Improve ~NextJS~ All Examples Documentation Oct 24, 2024
@fmontes
Copy link
Member

fmontes commented Oct 24, 2024

I updated, so we do it for all the examples.

@fmontes fmontes changed the title SDK: Improve ~NextJS~ All Examples Documentation SDK: Improve All Examples Documentation Oct 24, 2024
@zJaaal zJaaal moved this from Gardening Day Backlog to Next 1-3 Sprints in dotCMS - Product Planning Feb 19, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: Next 1-3 Sprints
Development

No branches or pull requests

3 participants