Skip to content

Separate doc bots for services and workflows - #2

Open
georgiesamaha wants to merge 2 commits into
mainfrom
tests
Open

Separate doc bots for services and workflows #2
georgiesamaha wants to merge 2 commits into
mainfrom
tests

Conversation

@georgiesamaha

Copy link
Copy Markdown
Member

This pull request updates the documentation to support two types of AI-assisted authoring workflows: BioCommons how-to guides and Nextflow DSL2 workflow READMEs. The changes clarify which files to use for each workflow, standardize file locations and names, and provide tailored instructions for both documentation types. The most important changes are:

General Documentation and Workflow Support:

  • The README.md now covers both BioCommons how-to guides (in service/) and Nextflow DSL2 workflow READMEs (in workflow/), with clear instructions and quickstart guides for each.

File Naming and Structure Updates:

  • All references to context and conventions files for BioCommons guides have been updated: llms.txt is now service/llm.txt, and GUIDE_CONTEXT.md is now service/SERVICE_CONTEXT.md. Instructions and file tables in both README.md and AI_AUTHORING.md have been updated accordingly. [1] [2] [3] [4] [5]

Nextflow Workflow Documentation Support:

  • Added documentation and instructions for the new workflow/ folder, which provides conventions and workflow for documenting Nextflow DSL2 pipelines using the SIH template. This includes a dedicated quickstart and guidance for supplying source files as context.

Clarifications and Improvements:

  • Expanded the explanation of what the AI can and cannot do for both documentation types, and updated related resource links to include Nextflow template resources.

These changes make the repo more flexible and easier to use for different documentation scenarios, ensuring users select the correct files and instructions for their needs.

@wiz-8f2719713e

Copy link
Copy Markdown

Wiz Scan Summary

Scanner Findings
Vulnerability Finding Vulnerabilities -
Data Finding Sensitive Data 2 Info
Secret Finding Secrets -
IaC Misconfiguration IaC Misconfigurations -
SAST Finding SAST Findings -
Software Management Finding Software Management Findings -
Total 2 Info

View scan details in Wiz

To detect these findings earlier in the dev lifecycle, try the Wiz Code extension for VS Code, JetBrains, or Visual Studio.

Comment thread workflow/llm.txt

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Info Sensitive Data Finding

PII

More Details
Attribute Value
Data Classifier PII/Name
Data Classifier ID BUILTIN-125

Sampled Examples

Key Value Row Number
by S****y 3

Rule ID: BUILTIN-125


To ignore this finding as an exception, reply to this conversation with #wiz_ignore reason

If you'd like to ignore this finding in all future scans, add an exception in the .wiz file (learn more) or create an Ignore Rule (learn more).


To get more details on how to remediate this issue using AI, reply to this conversation with #wiz remediate

Comment thread workflow/llm.txt

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Info Sensitive Data Finding

PII

More Details
Attribute Value
Data Classifier PII/Citizenship
Data Classifier ID BUILTIN-238

Sampled Examples

Key Value Row Number
national Aur*a 9

Rule ID: BUILTIN-238


To ignore this finding as an exception, reply to this conversation with #wiz_ignore reason

If you'd like to ignore this finding in all future scans, add an exception in the .wiz file (learn more) or create an Ignore Rule (learn more).


To get more details on how to remediate this issue using AI, reply to this conversation with #wiz remediate

@georgiesamaha georgiesamaha changed the title Tests Separate doc bots for services and workflows Jul 28, 2026
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.

1 participant