Skip to content

Conversation

@chr-tatu
Copy link
Contributor

@chr-tatu chr-tatu commented Dec 29, 2025

tl;dr: Documentation cleanup and maintenance

This PR removes outdated and unmaintained documentation, fixes broken links, and improves formatting across the README repository:

  • Removed outdated content (engineering principles, what-is-artsy, highlights, conference notes)
  • Deleted unmaintained documentation (juniors guide, learning group, releases)
  • Fixed broken and dead links across resources, tech-learning, and other sections
  • Improved RFC documentation with proper formatting and summaries
  • Updated career ladder and hiring documentation
  • Applied consistent formatting with prettier

@chr-tatu chr-tatu force-pushed the chr-tatu/documentation-update branch from 5fceb2f to cfef6f8 Compare December 31, 2025 13:22
@chr-tatu chr-tatu force-pushed the chr-tatu/documentation-update branch from 1e01e67 to 80c5f38 Compare January 5, 2026 14:21
@chr-tatu chr-tatu requested review from a team, evaschilken and rabidpaul January 5, 2026 16:29
@chr-tatu chr-tatu marked this pull request as ready for review January 5, 2026 16:29
@chr-tatu chr-tatu changed the title [WIP] Clean-up README docs: Clean-up README Jan 5, 2026
@chr-tatu chr-tatu self-assigned this Jan 5, 2026
@chr-tatu chr-tatu requested a review from joeyAghion January 6, 2026 13:10
## Technical Leads

Every team at Artsy has a Technical Lead who is part of the Core Team (Product Manager, Technical Lead, Data Analyst, Product Designer and Engineering Manager). The Technical Lead's key responsibilities are:
Every team at Artsy has a Technical Lead who is part of the Core Team (Product Manager, Technical Lead, Data
Copy link
Contributor

Choose a reason for hiding this comment

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

Do we still have the Technical Lead role? I thought project captains replaced it.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Nice catch! I'll remove it.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Wait, we still have the TL role, we didn't take yet the decision to fully remove it. I'll keep this for now.


<!-- end_toc -->
<!-- prettier-ignore-end -->
<!-- prettier-ignore-end -->undefined
Copy link
Contributor

Choose a reason for hiding this comment

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

Is this undefined an artifact that prettier is putting in or another formatter?

Copy link
Contributor

Choose a reason for hiding this comment

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

Good eye! My guess is there's a bug around here in the pre-commit script.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Nice catch @rabidpaul ! I think I was merging this PR as you were commenting. I created #566 to remove it.

I did try to remove the and at some moment, but the pre-commit hook added them back, maybe undefined was added then 🤷 .

Copy link
Contributor Author

@chr-tatu chr-tatu Jan 8, 2026

Choose a reason for hiding this comment

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

@joeyAghion : Created this PR to fix the pre commit hook and make the commit fail, in case there's an error.

@chr-tatu chr-tatu merged commit 27dc18e into main Jan 7, 2026
2 checks passed
@chr-tatu chr-tatu deleted the chr-tatu/documentation-update branch January 7, 2026 21:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants