Skip to content

chore: Improve builder-server documentation#792

Merged
cyaiox merged 11 commits intomasterfrom
chore/add-documentation
Dec 29, 2025
Merged

chore: Improve builder-server documentation#792
cyaiox merged 11 commits intomasterfrom
chore/add-documentation

Conversation

@cyaiox
Copy link
Member

@cyaiox cyaiox commented Dec 22, 2025

This PR improves the current builder-server documentation, enhancing the README.md and adding the database schema definitions.

@cyaiox cyaiox force-pushed the chore/add-documentation branch from 0ea4885 to 7f6714a Compare December 22, 2025 15:36
@coveralls
Copy link

coveralls commented Dec 22, 2025

Pull Request Test Coverage Report for Build 20576242409

Details

  • 0 of 0 changed or added relevant lines in 0 files are covered.
  • No unchanged relevant lines lost coverage.
  • Overall coverage remained the same at 71.527%

Totals Coverage Status
Change from base Build 19477584592: 0.0%
Covered Lines: 3230
Relevant Lines: 4332

💛 - Coveralls

Copy link
Contributor

@LautaroPetaccio LautaroPetaccio left a comment

Choose a reason for hiding this comment

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

LGTM! 👍 I've left a couple of comments to review

README.md Outdated
- **[Catalyst](https://github.com/decentraland/catalyst)**: Content server for deployed scenes and wearables
- **[Subgraph APIs](https://subgraph.decentraland.org)**: Blockchain data for collections, items, and third parties

External dependencies:
Copy link
Contributor

Choose a reason for hiding this comment

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

WDYT about not differentiating between external an "internal" dependencies?

README.md Outdated
```

First, run all services simultaneously with:
Key environment variables:
Copy link
Contributor

Choose a reason for hiding this comment

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

Would you mind creating a .default.env with all the required variables to run the service and removing this section so there's a single place where all of them live? Would you also mind to adding comments to these variabrles as they're described here in the description column?

Copy link
Member Author

Choose a reason for hiding this comment

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

we already have the .env.example file with the default values to run the service. I'll update it with the comments

README.md Outdated
Comment on lines 209 to 215
#### Windows Subsystem for Linux (WSL)

If using WSL, start PostgreSQL service before running:

```bash
sudo service postgresql start
```
Copy link
Contributor

Choose a reason for hiding this comment

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

WDYT about removing this section as it's related to using PostgreSQL?

@cyaiox cyaiox merged commit cdedbe8 into master Dec 29, 2025
6 checks passed
@cyaiox cyaiox deleted the chore/add-documentation branch December 29, 2025 15:21
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.

4 participants