docs: Fix Python connector tutorial environment setup documentation

[devin-ai-integration]

What

Fixes the environment setup documentation for the custom Python connector tutorial, which had numerous issues making it impossible to follow successfully.

Issues fixed:

• Removed duplicate git clone instructions (appeared twice in the original)
• Fixed inconsistent connector naming (was source-exchange-rates-tutorial in some places, source-survey-monkey-demo in others)
• Added missing critical setup steps (source module creation, pyproject.toml configuration, entry points)
• Replaced vague instructions with complete, working code examples
• Fixed references to files that didn't exist (secrets/config.json, configured_catalog.json)
• Updated verification steps to show successful output instead of expected failures

Requested by @ian-at-airbyte

How

Complete rewrite of the documentation to provide step-by-step instructions that:

1. Add a prerequisites section listing required tools
2. Provide complete pyproject.toml with proper entry point configuration
3. Include all necessary Python files (__init__.py, source.py, run.py, main.py)
4. Add spec.yaml with proper connector specification format
5. Include test configuration files (secrets/config.json, configured_catalog.json)
6. Add verification steps using spec and check commands
7. Include final project structure overview

Updates since last revision

• Added title="filename.extension" attributes to all code blocks for improved clarity
• Clarified that the secrets/ directory exclusion is from the Airbyte repository's .gitignore (per reviewer feedback)

Review guide

1. docs/platform/connector-development/tutorials/custom-python-connector/1-environment-setup.md - Single file change, complete rewrite

Key areas to verify:

• pyproject.toml configuration follows current Poetry/CDK best practices
• Python code examples are syntactically correct
• spec.yaml format is valid for the Airbyte CDK
• Tutorial flows logically into the next page (2-reading-a-page.md)
• Code block titles match the file paths mentioned in the text

User Impact

Users following the Python connector tutorial will now be able to complete the environment setup successfully and have a working connector skeleton ready for the next tutorial section.

Can this PR be safely reverted and rolled back?

• YES 💚

---

Link to Devin run: https://app.devin.ai/sessions/afe4af8e6513476b942a627e7e3d9f9e

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[ian-at-airbyte]

Is this true about Git?

[devin-ai-integration]

Yes, this is accurate. The root .gitignore file contains:

# Secrets
secrets
!airbyte-integrations/connector-templates/**/secrets

This excludes all secrets/ directories from Git tracking (except for connector templates which need placeholder secrets for scaffolding).

[ian-at-airbyte]

Oh. This is based on the airbyte project's gitignore?

[devin-ai-integration]

Yes, this is based on the Airbyte monorepo's root .gitignore. Since this tutorial is specifically about developing connectors within the Airbyte repository, the secrets/ directory will be automatically excluded.

Should I clarify this in the documentation to make it more explicit that this applies when working within the Airbyte repository?

[ian-at-airbyte]

Probably. It confused me for a moment.

[devin-ai-integration]

I've updated the documentation to clarify this. The text now reads: "The Airbyte repository's .gitignore excludes the secrets/ directory by default."