Update job writing guide docs

[mtuchi]

Short Description

Improve job writing guide docs by grouping into smaller topics and add warning message on Referencing credentials in job code section. [See advanced concept page]

Closes #714

Details

• Group job writing guide content into specific topic files and update sidebar
• Add a warning about Referencing credential secretes in job code

AI Usage

Please disclose how you've used AI in this work (it's cool, we just want to
know!):

• Code generation (copilot but not intellisense)
• Learning or fact checking
• Strategy / design
• Optimisation / refactoring
• Translation / spellchecking / doc gen
• Other
• I have not used AI

You can read more details in our
Responsible AI Policy

[mtuchi]

Hey @hunterachieng Please review my pr and share your feedback, See my quick walk through video here

[josephjclark]

This PR confused me a bit until I figured out what you were doing!

Generally I approve, I think it's great. Just a couple of suggestions before I'm ready to merge

[josephjclark]

You know what @mtuchi, I just was just taking a final look over this and the menu is now like this:

Write Jobs
  - Job Writing Guide
  - Security Considerations

It's a bit strange to have just two submenus, and "Write Jobs" and "Job Writing Guide" are basically the same

So! What if we remove Job Writing Guide and re-parent each section under Write Jobs? That's way cleaner, and the Security page becomes just another section of the guide.

[mtuchi]

It's a bit strange to have just two submenus, and "Write Jobs" and "Job Writing Guide" are basically the same

So! What if we remove Job Writing Guide and re-parent each section under Write Jobs? That's way cleaner, and the Security page becomes just another section of the guide.

Yeah totally agree @josephjclark , let me do that

[mtuchi]

@josephjclark
I have added all job writing sections under Write Jobs category

job-write.mp4