Catana Documentation
  • 🐱Overview
    • Introduction
    • Installation
  • 📖Core concepts
    • Regular and expiring TODOs
    • Assigning TODOs
    • Create, update and delete
    • Validation
    • Ignored TODOs
  • 🔔Triggers
    • Overview
    • Date
    • GitHub Issue closed
    • GitHub Pull Request closed
    • Ruby Gem released
    • Ruby Gem upgraded
    • Ruby Version released
    • Ruby Version upgraded
  • 🤖Commands
    • Overview
    • Done
    • Bump
    • Link
  • 🔗Grouped TODOs
    • Overview
  • ⚙️Configuration
    • Open GitHub issues
    • Enforce expiring TODOs
    • Rules
    • Exclusion list
Powered by GitBook
On this page
  • Consistency
  • Errors

Was this helpful?

  1. Core concepts

Validation

Keep TODOs across your codebase consistent and error free.

PreviousCreate, update and deleteNextIgnored TODOs

Last updated 9 months ago

Was this helpful?

Catana has a feature to validate TODOs before they land on the release branch of an enrolled repository. This validation serves two purposes.

  1. Keep TODOs across your codebase consistent.

  2. Prevent errors.

Consistency

In the same fashion as linters, which help keep code style consistent in your project, maintaining consistency in your TODOs through a set of conventions helps in managing them more easily, particularly if you don't use Catana!

An example of such a convention is Catana's default behavior for explicitly assigning users. Team members can quickly identify and direct their questions to TODO authors or assignees without leaving the code editor or going through a git blame dance. It also promotes a better sense of accountability.

Errors

Mistakes happen, and Catana is here to warn developers before merging a Pull Request. For instance, Catana will provide feedback in the event where a developer assigns a TODO to a user that doesn't exist or is not a team member.

We all know that overly strict validation can be frustrating (ever had your first name fail validation on a form?), and Catana aims to be as unobtrusive as possible while preventing developers from shooting themselves in the foot.

Catana's validation will kick in automatically once a Pull Request not in is opened.

📖
draft mode