Skip to content

Update docapis_ai_what_works_and_doesnt.md #36

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.

Sign up for GitHub

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update docapis_ai_what_works_and_doesnt.md #36

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions _ai/use-cases-for-ai/docapis_ai_what_works_and_doesnt.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,11 +51,11 @@ But as I've tried to use AI tools to write blog posts, brainstorm, upgrade my si

My general strategy for using AI is as follows: In which tasks do AI tools excel, but which humans perform poorly? Those are the tasks to use AI.

To determine what works and doesn't, I try AI tools out in real tech comm scenarios. Nothing moves you past the hype cycle's peak more than actually trying AI out in documentation-related tasks. Although full access to tool usage for corporate documentation is still heavily restricted, I've often resorted to using the tools on my API course content, blog, and elsewhere. I've found the following 10 scenarios to work well.
To determine what works and doesn't, I try AI tools out in real tech comm scenarios. Nothing moves you past the hype cycle's peak more than actually trying AI out in documentation-related tasks. Although full access to tool usage for corporate documentation is still heavily restricted, I've often resorted to using the tools on my API course content, blog, and elsewhere. I've found the following 9 scenarios to work well.

## 10 tech comm use cases for AI
## 9 tech comm use cases for AI

The following are 10 scenarios where AI works well:
The following are 9 scenarios where AI works well:

* [Develop build and publishing scripts](ai-tools-build-publish-api-docs.html)
* [Understand the meaning of code](docapis_ai_learn_coding.html)
Expand Down Expand Up @@ -231,4 +231,4 @@ She advocated for transparency from the AI developers, pushing them to expose mo

By mastering the latest techniques for guiding and collaborating with AI systems hands-on, Sarah evolved into an expert curator who can oversee, optimize, and enhance the AI's contributions. Her adaptability future-proofed her role. She no longer wrote documentation by hand but instead spent her time working as an AI document engineer, fine tuning the models to work better with her content.

Soon Sarah became invaluable as a producer who knew how to get the best out of the AI tools, combining automated scale with craft and quality oversight. She shifted from just an operator to a documentation engineer collaborating with AI in service of human users' needs. Her adaptability and willingness to evolve made her essential for the company’s success in an AI world.
Soon Sarah became invaluable as a producer who knew how to get the best out of the AI tools, combining automated scale with craft and quality oversight. She shifted from just an operator to a documentation engineer collaborating with AI in service of human users' needs. Her adaptability and willingness to evolve made her essential for the company’s success in an AI world.