[Epic] FY24Q4 area/docs content and requests

[interurban]

Thesis

In Q4 we will continue to invest in conceptual docs that users need to scale from trial to production use cases, ensuring customers have the resources they need to understand the advanced areas of Pulmui. We started in Q3 with inputs/outputs and will continue with concept docs for resources, stacks and projects, state, config and secrets.

Supporting Data

These docs sets are all within the top 50 most top docs pages and most common areas of posed by our community
It also aligns to our customer training that we deliver to help customers increase their proficiency and adoption of Pulumi.

P2 Items

Items tagged at P2, are below the line for this quarter but open for debate if they should be prioritized higher

Work Items

Conceptual Docs (P1)

Beta Give feedback

1. Resources concepts docs improvements #11233
   area/docs kind/enhancement size/M +3
2. Projects & stacks docs improvements #11234
   area/docs kind/enhancement +2
3. Document recommended project layout structures #11766
   area/docs customer/feedback kind/enhancement +3
   
4. Improve secrets concept pages #11228
   3 of 3
   area/docs kind/enhancement size/M +3
   
5. Configurations docs improvements #11235
   3 of 3
   area/docs kind/enhancement size/M +3
   
6. Parent/child relationships improvements #11236
   area/docs kind/enhancement size/M +3
   
7. Better document stack transformations #11784
   area/docs kind/enhancement size/S +3
   
8. Enhance outputs dependencies content #10782
   area/docs kind/enhancement size/M +3
   
9. Create Inputs/Outputs Deep Dive video series #10561
   area/docs kind/enhancement size/L +3
10. Stack Reference doc page should include mention of requireOutput() in the text and example(s) #11763
    area/docs kind/enhancement size/S +3
    
11. Review Secrets concepts content and define areas of improvement #11276
    area/docs kind/enhancement resolution/fixed size/S +4
    
12. Secrets concepts page engineering review #11320
    area/docs kind/enhancement resolution/fixed size/S +4
    
13. Review config concept content and define areas of improvement #11282
    area/docs kind/enhancement resolution/fixed size/M +4
    
14. [Config] Create and size corresponding improvement issues #11283
    area/docs kind/enhancement resolution/fixed size/XS +4
    
15. Config concept page engineering review #11403
    area/docs kind/enhancement resolution/fixed size/S +4
    

April Launch Docs (P1)

Beta Give feedback

1. Improve drift docs #11323
   area/docs kind/enhancement size/M +3
   
2. Improve schedules docs #11324
   area/docs kind/enhancement +2
3. Improve ttl docs #11325
   area/docs kind/enhancement +2

TF Docs (P1)

Beta Give feedback

1. Can’t find docs for bootstrapping new users #11728
   area/docs customer/feedback kind/enhancement needs-design +4
2. Migration User Guides #11516
   area/docs kind/enhancement +2
3. Add HCL code examples to /terraform page #11589
   +0
   

Troubleshooting (P1)

Beta Give feedback

1. Add debugging how to guide #11326
   area/docs kind/enhancement +2
   
2. Add debugging how to short form video walkthrough #11327
   area/docs kind/enhancement +2
   
3. CLI flag to launch Pulumi program under a debugger pulumi#1372
   area/cli impact/quality kind/enhancement language/dotnet language/go language/javascript language/python +7
   
4. Multiple problems with S3 Backend documentation and usage #11755
   area/docs good-first-issue kind/enhancement +3
   
5. Mention backend configuration in backend documentation #11759
   area/docs kind/enhancement +2

Q4 Broken Examples (to be prioritized)

Beta Give feedback

1. How-To guide for ECS doesn't work #11442
   area/docs docs/examples needs-triage resolution/fixed size/S +5
   

Additional area/docs kind/bug (P2 below the line)

Beta Give feedback

1. Transformation Resource Option Page Doesn't Provide a Complete Example #11652
   area/docs kind/enhancement size/S +3
2. Be clear about getter function results being under management of Pulumi #11665
   area/docs kind/enhancement +2
3. Missing documentation on locking for S3 (and other cloud buckets?) #11679
   area/docs docs/content kind/enhancement +3
4. apt-get to install sudo #11620
   area/docs docs/service kind/bug +3
5. Resource lookup *is* supported in YAML, but the registry claims it is not registry#4279
   area/api-docs kind/bug kind/enhancement size/M +4
6. Pulumi policy as code concepts - Stack policies needs clarification #11508
   area/docs kind/bug +2
   

AWS Guides (P2 below the line)

Beta Give feedback

1. Add all supported languages to AWS EKS guide #11202
   area/docs kind/enhancement size/L +3
2. Add all supported languages to the AWS EC2 guide #11491
   area/docs kind/enhancement resolution/fixed size/M +4
   
3. Add all supported languages to the AWS IAM guide #11490
   area/docs blocked kind/enhancement resolution/fixed size/L +5
   
4. Add all supported languages to Lambda guide #11203
   area/docs kind/enhancement size/M +3
5. Add all supported languages to CloudWatch guide #11200
   area/docs kind/enhancement size/M +3

Kubernetes Guides (P2 below the line)

Beta Give feedback

1. Inventory of all K8 Guides/Howtos #11199
   area/docs size/S +2