Skip to content

docs: restructure Academy #2040

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

Jump to bottom
Merged
merged 10 commits into from
Oct 29, 2025
Merged

docs: restructure Academy #2040

merged 10 commits into from
Oct 29, 2025

Conversation

@TC-MO
Copy link
Contributor

@TC-MO TC-MO commented Oct 23, 2025 •
edited
Loading

As per slack discussion & notion, here is PoC with reworked structure & placeholders for new content. Work done so far:

  • create new Build and publish section
  • move content
  • move images
  • remove H1's
  • fix formatting
  • create placeholders
  • remove AI section

Work to be done:

  • fix initial Vale issues
  • remove placeholder descriptions from pages
  • add new content
    • Why publish Actors
    • What software an Actor can be
    • Validation framework
    • Affiliates

@TC-MO
docs: restructure Academy
590bf31 
expand Actor Marketing playbook prominence
create new Build and publish section
move content
move images
remove H1's
fix formatting
create placeholders
@TC-MO TC-MO self-assigned this Oct 23, 2025
@TC-MO TC-MO added documentation Improvements or additions to documentation. t-docs Issues owned by technical writing team. labels Oct 23, 2025
@apify-service-account
Copy link

Preview for this PR was built for commit 4064678 and is ready at https://pr-2040.preview.docs.apify.com!

TC-MO added 3 commits October 28, 2025 12:27
@TC-MO
add new content
3fbb2ea 
Remove placeholder content
Add new content
Fix formatting
Add new positions to accept.txt
@TC-MO
Merge branch 'master' into academy-restructure
55a0f02
@TC-MO
fix broken links
c533f38
@apify-service-account
Copy link

Preview for this PR was built for commit c533f38d and is ready at https://pr-2040.preview.docs.apify.com!

@apify-service-account
Copy link

Preview for this PR was built for commit e0b8fc5d and is ready at https://pr-2040.preview.docs.apify.com!

@TC-MO TC-MO marked this pull request as ready for review October 28, 2025 17:38
@TC-MO TC-MO requested a review from honzajavorek as a code owner October 28, 2025 17:38
@TC-MO
Copy link
Contributor Author

TC-MO commented Oct 28, 2025

PR is ready for review. I've added missing content for the following pages

  • Why publish Actors
  • What software an Actor can be
  • Validation framework
  • Affiliates

One suggestion comes to mind, that Actor success stories separate page feels a bit redundant. Most of the content fit nicely into a single heading within Why publish Actors so my suggestions would be to remove it and leave it as part of Why publish Actors

jancurn
jancurn reviewed Oct 28, 2025
View reviewed changes
Copy link
Member

@jancurn jancurn left a comment

Choose a reason for hiding this comment

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

Looks great from a quick look

@TC-MO
docs: update links
173c62f 
add links to scrapers from Apify Store
add link to Actor quality score docs
@apify-service-account
Copy link

Preview for this PR was built for commit 173c62f6 and is ready at https://pr-2040.preview.docs.apify.com!

patrikbraborec
patrikbraborec approved these changes Oct 29, 2025
View reviewed changes
sources/academy/build-and-publish/why_publish.md

---

## What you get when you publish on Apify
Copy link
Contributor

Choose a reason for hiding this comment

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

Nit: the page is Why publish Actors on Apify but we are starting with What...

sources/academy/build-and-publish/why_publish.md Outdated

Ready to publish? The process involves four main stages:

1. Development: Build your Actor using Apify SDKs, Crawlee, or code templates
Copy link
Contributor

Choose a reason for hiding this comment

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

code templates -> actor templates

Copy link
Contributor

Choose a reason for hiding this comment

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

Can we add link to actor templates?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

added links to:

  • SDKs
  • Crawlee
  • Actor templates

@jancurn
Copy link
Member

jancurn commented Oct 29, 2025

I suggest we merge this ASAP and fix the details later, so that we can get the final links that we can add to actorization page etc. It's not like we're taking some irreverible actions...

@TC-MO
Copy link
Contributor Author

TC-MO commented Oct 29, 2025

Yup I was waiting for approval as it is required to be able to merge, I'm making final fixes based on Patrick's review and will be merging that PR

@apify-service-account
Copy link

Preview for this PR was built for commit dc22480e and is ready at https://pr-2040.preview.docs.apify.com!

@apify-service-account
Copy link

Preview for this PR was built for commit 2f240e8f and is ready at https://pr-2040.preview.docs.apify.com!

@TC-MO TC-MO merged commit c514252 into master Oct 29, 2025
9 checks passed
@TC-MO TC-MO deleted the academy-restructure branch October 29, 2025 18:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@jancurn jancurn jancurn approved these changes

@patrikbraborec patrikbraborec patrikbraborec approved these changes

@honzajavorek honzajavorek Awaiting requested review from honzajavorek honzajavorek is a code owner

Assignees

@TC-MO TC-MO

Labels

documentation Improvements or additions to documentation. t-docs Issues owned by technical writing team.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@TC-MO @apify-service-account @jancurn @patrikbraborec