Skip to content

Conversation

@worktheclock
Copy link

📝 What does this PR do?

Improves the Quickstart guide structure and clarity to help new users deploy faster with less confusion. Key changes include reorganizing content for better logical flow, rewriting deployment instructions with clearer formatting, and standardizing terminology throughout.

🔗 Related Issue (if applicable)

N/A


🧪 Type of Change

  • ⚠️ Bug fix
  • 📅 Changelog update
  • 📚 Documentation update
  • ✨ New content/feature
  • 🔧 Technical/maintenance

✅ Quick Checklist

  • I have read the contributing guidelines
  • The content is accurate and links work
  • The site builds without errors

👥 Reviewers

@CleverCloud/reviewers


I specialize in helping development platforms improve documentation to reduce support load and improve user activation. Reach out if you'd like to discuss further documentation improvements.

This PR improves the Quickstart guide to help new users deploy faster with less confusion:

**Structure improvements:**
* Moved "How Clever Cloud works" earlier so users understand the deployment model before creating accounts
* Reorganized add-on information for better logical flow

**Clarity improvements:**
* Rewrote deployment instructions with clearer step-by-step formatting
* Tightened explanations throughout to reduce cognitive load
* Standardized terminology and capitalization for consistency

**User experience improvements:**
* Updated description to be more action-oriented and specific
* Improved GitHub authentication instructions with clearer navigation paths
* Enhanced add-on billing explanation for better understanding

These changes reduce friction for developers getting started with Clever Cloud while maintaining technical accuracy.

---

I specialize in helping development platforms improve documentation to reduce support load and improve user activation. Reach out if you'd like to discuss further documentation improvements.
@github-actions
Copy link

github-actions bot commented Oct 2, 2025

✅ Review app deployed

Check how your changes look like!

ℹ️ Name 🔗 Infos & links
🌱 Latest deployed commit cd23e89
👁️ Preview https://documentation-PR-801.cleverapps.io/developers

Copy link
Collaborator

@davlgd davlgd left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for this. Could you please split in multiple commits? It will help us to see what's moved, what's change and ease the review process.

@worktheclock
Copy link
Author

Thanks for the feedback. I've created a new PR with changes split into separate commits: #802

Closing this one in favor of the new PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants