This is not a real post, but several examples of a self-promotion post that would need to meet the requirements of rules 7 & 8. The links will all go to the wiki I've started on Codeberg. While none of it was created with an LLM, its being used as a sample link.
These are the categories for a disclosure. Only those with AI assistance (at any level) get listed.
- Design - architecture, system design
- Implementation - production code
- Testing - writing tests, test plans, and QA.
- Documentation - Docs, comments, README, change logs
- Review - Code review and pull request feedback
- Deployment - CI/CD configuration.
Each category that uses AI is then shown, along with the level of AI involvement. There are four levels of AI support to then use:
- Hint - AI suggested solution, human does the task.
- Assisted - AI acts on part of a task, but a human handled the bulk.
- Pair - About a 50/50 split of human made and generated.
- Generated - Human prompted, AI generated.
A few different examples are shown below
Example 1 - A human prompted, and AI generated everything
I made a thing! It does stuff, and you can find it at codeberg. Its open source, and since my account is more than 30 days old I can post about it here!
AI Disclosure:
- Design - Generated
- Implementation - Generated
- Testing - Generated
- Documentation - Generated
- Review - Generated
- Deployment - Generated
Since AI generated everything from a prompt, and each category is involved in my fake project, all categories are displayed
Example 2 - Mixed levels of AI use for the entire project, except for the Design (architecture/system design)
I made a thing! It does stuff, and you can find it at codeberg. Its open source, but there is a paid subscription component. My account is more than 30 days old and I regularly post and comment without promoting my project for at least 90% of my posts/comments, so I can post about it here!
AI Disclosure:
- Implementation - Generated
- Testing - Hint
- Documentation - Pair
- Review - Assisted
- Deployment - Generated
As the design came entirely from a human, it does not need to be listed. Everything after that though involved AI, so they do need to be listed.
This tells the community that the implementation (code) and deployment (CI/CD pipeline) were entirely handled by AI from a prompt.
For testing, I asked AI for the best way to handle it, but implemented the test plans, tests, and performed the QA myself.
The documentation was about a 50/50 split on effort, because I used AI to generate the readme, changelogs, and some of the general documentation, while the rest of the documentation and all of the comments were handled by a person.
Review (code review / pull request feedback) was mostly handled by a person, but still involves AI in some of the effort.
Example 3 - I used AI to help me work with a piece of hardware over a serial connection, and nothing else
I made a thing! It does stuff, and you can find it at codeberg. Its open source, and since my account is more than 30 days old I can post about it here!
AI Disclosure:
Note: I only used AI to figure out how to communicate with this weird device I bought from a garage sale and couldn't find any documentation on the protocol.
Since I only used AI to figure out how to talk to the device, and through that series of AI prompts I came up with the code for the communication protocol which I then wrote entirely myself, only Implementation is listed.
Since it was such a small part, I decided to note how I used it, both to show that this came mostly from me, but also by mentioning it this is where folks may want to pay attention if they want to contribute. Someone may be familiar with the device I found at a garage sale, and has a printed copy of the 40yr old manual that includes the protocol.
Example 4 - I used AI in some way, but I've already made that clear in the git repository with an AI declaration file.
I made a thing! It does stuff, and you can find it at codeberg. Its open source, and since my account is more than 30 days old I can post about it here!
AI Disclosure can be found in the git repository here.
Since I've already created an AI disclosure document in my repository, I don't need to declare it again here. Instead, I can link to that disclosure for everyone to easily find and get the full details.
Hopefully this helps clear up any confusion around how to make an AI disclosure. If you have any questions please feel free to message before posting.
