Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Explain deployment artifacts and their supported roles

Open Beginner friendly
  • Is something wrong?
#282 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
88/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
aws, docker-compose, terraform
Domain
cloud, devops, documentation

Research direction

Read docs/src/content/docs/guides/deployment.md, docs/src/content/docs/reference/text.md, docs/astro.config.mjs, and example.env on current main, using audit 9d8ac3e01df1 as a starting point. Create only docs/src/content/docs/guides/roadmap/ecs-vs-compose.md, distinguishing shipped artifacts from operator-owned AWS setup and covering cache and writable-storage needs without presenting Terraform as available. Run npm --prefix docs ci, npm --prefix docs run build, and git diff --check.

Written by the indexing model from the issue text.

Description

area:docs contributor-roadmap difficulty:beginner documentation good first issue help wanted status:ready

DOC-12 · Documentation and accessibility

Difficulty: beginner · Status: ready

This is a focused contribution against current main. No unmerged feature PR is required.

Why this is useful

Compose is implemented while ECS setup is largely guidance

Start here

Source audit: 9d8ac3e01df1. Read these files on current main too, because paths may change after the audit:

Scope and intended output

Write docs/src/content/docs/guides/roadmap/ecs-vs-compose.md; keep this contribution in its own page. Maintainers can add navigation links after merge to avoid concurrent sidebar edits.

Acceptance criteria
  • List what the repo actually ships versus operator-owned AWS setup
  • Explain cache and writable-storage needs
  • Do not present future Terraform as available
Verification
npm --prefix docs ci
npm --prefix docs run build
git diff --check

Build the docs site locally. Verify the described commands against current source; explicitly report platform steps you could not execute. Do not run paid examples as a build check.

Dependencies

None. Keep the PR based on current upstream main.

Out of scope
  • Unrelated refactors, broad formatting, endpoint renames, or extra dependencies without agreement.
  • Live cloud provisioning, paid model calls, real private messages, or credentials in fixtures/logs.
  • Implementing neighboring roadmap issues in the same PR.
Getting help and submitting

Comment with your intended approach and ask when expected behavior is unclear. Check for an existing PR before starting; there is no deadline for a volunteer contribution. A useful reproduction or partial finding is welcome.

Use the issue's criteria as the review checklist. Include the commands actually run and any limitations. Link the issue; use Fixes only when its entire agreed scope is complete. If CONTRIBUTING.md is not yet on main, the contributor-roadmap PR provides the onboarding guide.

Dominant language
Python
Stars
3
Forks
10
Avg merge
8h 11m
Merged PRs (30d)
18

Getting set up

We have not checked this project's setup files yet. Start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from ashrafee-dev/scamshield-api

All issues in ashrafee-dev/scamshield-api

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.