Skip to content

MarrieMitsu/workspace-101

Repository files navigation

Workspace-101

This document establishes an opinionated guiding framework for file organization and project management, designed to accommodate users of all technical backgrounds. It provides a simple, copy-and-paste system for creating new project workspaces, archiving completed work, and syncing cloud storage, ensuring a clean, accessible, and efficient environment.

Getting Started

The guide is available online at https://workspace-101.pages.dev or in PDF format on the releases page

Deploying and Publishing

This project uses the just command runner alongside external utility program like typst, typos, git, and git-cliff.

Workflow

  1. Make your changes.
  2. just clean
  3. just check (fix any typos), then just format
  4. Commit using Conventional Commits and Keep a Changelog specifications.
  5. just bump-calver (Only if workspace.md, workspace.typ, or install/* changed)
  6. just build
  7. just deploy (Only if workspace.md or website.typ changed)
  8. just publish (Only if releasing a new version)

Contributing

If you notice something wrong or broken, let us know by opening an issue, or better yet, a pull request with how you think it should be fixed.

Changelog

CHANGELOG

License

Released under the MIT license. See LICENSE.

About

An opinionated guiding framework for file organization and project management, designed to accommodate users of all technical backgrounds

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors