Skip to content

Conversation

@cesarParra
Copy link
Owner

@cesarParra cesarParra commented Oct 17, 2024

Overview

Provides support for generating documentation for Custom Objects (SObjects).

Tasks

Parsing

  • Parse XML .object
    • Parse label
    • Parse description
    • Parse visibility
      • Must either not be there or be public
    • Deployment status
      • Must be deployed
    • Validation
  • Parse XML .field
    • Parse field name
    • Parse description
    • Validation

Markdown support

Here is an example of what we want to output: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_accountcontactrelation.htm

  • Read files
    • Read .object meta files
    • Read .field meta files
  • Data pipeline
    • Parse
    • Filter non-public/non-published
    • To Renderable
    • Compile through template
      • Hooks support
  • Write files
  • Config
    • Configurable group name (for reference guide)
    • Ability to turn on/off reading SObjects

@cesarParra cesarParra marked this pull request as ready for review October 20, 2024 11:44
@cesarParra cesarParra merged commit 4f03bff into develop Oct 20, 2024
1 check passed
@cesarParra cesarParra deleted the markdown-sobjects branch November 6, 2024 15:46
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.

2 participants