Skip to content

docs: update publish task naming and add unpublish section - #2855

Draft
jgagne wants to merge 9 commits into
masterfrom
docs/publish-task-update
Draft

docs: update publish task naming and add unpublish section#2855
jgagne wants to merge 9 commits into
masterfrom
docs/publish-task-update

Conversation

@jgagne

@jgagne jgagne commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Changes

New feature documentation

  • Use case field (required, for Store categorization)
  • AI icon for generating SEO title and description
  • Publishing tab progress guide
  • Publish confirmation (privacy reassurance)
  • After publishing: share dialog and View landing page button
  • Privacy note in "After a user tries your task"
  • Prerequisites: blocking state when schemas are missing

SEO

  • Meta description rewritten: removes jargon, states outcome plainly
  • Weak/strong task title table: trimmed from 5 rows to 3, three examples are enough to make the point. Replaced with real example task titles from Google Maps Scraper, now names a specific city for stronger location targeting

Naming (from original PR)

  • "Publication" tab to "Publishing"
  • "Display information" to "Page details"
  • "SERP preview" to "Google preview"
  • "Examples" tab to "Example tasks"

Screenshots to update

Screenshot Status Notes
task-publishing-tab.webp Verify Recaptured from renamed file, confirm UI matches
task-page-details.webp Verify Recaptured from renamed file, confirm UI shows "Page details"
task-unpublish-dialog.webp Missing Needs capture (Unpublish section is new)
actor-examples-tab.webp Verify Tab was renamed to "Example tasks"
task-input-section.webp OK No UI changes
task-dataset-schema.webp OK No UI changes
task-landing-page.webp OK No UI changes

Copy lint pass

  • Parallel user-centered intro: "what it does, what inputs to provide, and what output to expect"
  • "more discoverability means more paid runs" (docs voice, replaces marketing tone)
  • Plain language: "shows up in Google results" (replaces "indexed by search engines")
  • Slug: spells out constraints (lowercase, hyphens, no spaces)
  • "preview updates as you type" (replaces "live preview how fields propagate")
  • Consistent possessive ("your original task")
  • Remove redundant "automatically" and "public" where context implies them
  • Bold all UI element names in prose (Publishing tab, Input section, Dataset schema section)

@apify-service-account

apify-service-account commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

❌ Preview build for this PR (commit 88858974) failed. See action run for details.

@jgagne jgagne changed the title docs: fix publish task naming and add unpublish section docs: update publish task naming and add unpublish section Aug 5, 2026
@jgagne jgagne self-assigned this Aug 5, 2026
- Fixes the SEO title field label mismatch with its own required-field error.
- Renames the Publication tab to Publishing.
- Renames the Display information section to Page details.
- Renames SERP preview to Google preview.
- Fixes Page preview and Google preview from Title Case to sentence case.
- Renames the Examples tab to Example tasks.
- Removes redundant phrasing across the page.
- Adds a section on unpublishing a task.
- Placeholder: unpublish screenshot pending capture.
- Placeholder: Publish status filter pending shipping.
@jgagne
jgagne force-pushed the docs/publish-task-update branch 2 times, most recently from 55b393b to 0ce96c8 Compare August 5, 2026 21:05
jgagne added 2 commits August 5, 2026 23:08
Copy fixes:
- "what it does, what inputs to provide, and what output to expect"
  (parallel and user-centered, replaces "it produces")
- "more discoverability means more paid runs" (docs voice, not marketing)
- Slug: spell out constraints (lowercase, hyphens, no spaces)
- "preview updates as you type" (replaces "live preview how fields propagate")
- "your original task" (consistent possessive)
- Remove "automatically" from AI generation line (redundant with AI icon)
- Unpublish: state outcome of confirm action

New feature documentation:
- Use case field (required, for Store categorization)
- AI icon for generating SEO title and description
- Publishing tab progress guide
- Publish confirmation (privacy reassurance)
- After publishing: share dialog and View landing page button
- Privacy note in "After a user tries your task"
- Prerequisites: blocking state when schemas are missing
- Remove "public use-case" (redundant, not a search term)
- Remove implementation detail ("by completing the... sections")
- Add benefit: discoverable on Google and by AI agents
- Plain language pass on AI discovery section
@jgagne
jgagne force-pushed the docs/publish-task-update branch from 0ce96c8 to 2f0165c Compare August 5, 2026 21:09
@jgagne
jgagne force-pushed the docs/publish-task-update branch from 540686a to bf5e6d3 Compare August 5, 2026 21:13
- "task-publication-tab" to "task-publishing-tab" (matches renamed UI)
- "task-display-information" to "task-page-details" (matches renamed section)
- Alt text now describes what the screenshot shows, not just labels it
@jgagne
jgagne force-pushed the docs/publish-task-update branch from 741d4ce to 540e821 Compare August 5, 2026 21:22
@jgagne jgagne added the adhoc Ad-hoc unplanned task added during the sprint. label Aug 6, 2026
jgagne added 4 commits August 6, 2026 15:22
- Replaces two rows with real example task titles currently live on Google Maps Scraper, verified on apify.com.
- Keeps the "Generic task/Specific task" table headers as-is.
- Tightens the Amazon and Yahoo Finance strong titles to a single focus each, matching the section's own stated principle.
- Fixes the intro line to name all three Actors shown in the table.
- Updates a leftover "dentist" reference and the URL structure example to match the new table.
- Changes "Analyze local business competitors with AI" to "Analyze San Francisco business competitors with AI", naming an actual location instead of the placeholder word "local".
- Updates the matching sentence below the table to reference the new phrase.
- Simplifies the sentence after the table to "Each task focuses on a specific industry, location, or workflow", removing a redundant modifier on "task".
- Note: the San Francisco example is no longer verbatim from the live Google Maps Scraper Examples tab, it's a modified version. The other two rows in this table remain our own examples, not live ones.
@jgagne
jgagne force-pushed the docs/publish-task-update branch from d0ba748 to 8885897 Compare August 6, 2026 14:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

adhoc Ad-hoc unplanned task added during the sprint.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants