mirror of https://github.com/logos-co/logos-lips.git synced 2026-08-27 08:11:12 +00:00

T

fbarbu15 bb9d20bdef chore: scope linting (#355 )

Scoped markdown-lint workflow to PR-changed Markdown targets.

Adds target handling so metadata/generated-output validation runs
against changed docs, while markdownlint/remark continue linting only
non-raw changed Markdown files.

This PR was made with help from Codex

2026-06-11 10:31:09 +03:00

.github

chore: scope linting (#355 )

2026-06-11 10:31:09 +03:00

docs

chore: scope linting (#355 )

2026-06-11 10:31:09 +03:00

scripts

chore: scope linting (#355 )

2026-06-11 10:31:09 +03:00

theme

chore: add math support (#287 )

2026-02-09 14:28:19 +02:00

.gitignore

chore(blockchain): mirror SUMMARY tree on the Blockchain landing page (#340 )

2026-05-21 05:21:34 +02:00

.markdownlint.yaml

Chore: mirror blochain specs into github/mdbook (#347 )

2026-05-28 14:05:24 +03:00

.remarkignore

Chore/updates mdbook (#262 )

2026-01-19 14:34:33 +02:00

.remarkrc.mjs

chore: more loose md linting (#294 )

2026-02-26 19:11:49 +02:00

book.toml

Chore/move repo into logos co (#312 )

2026-04-15 15:44:03 +03:00

custom.css

chore: improve left panel (#352 )

2026-06-02 16:47:42 +03:00

flake.lock

ci: add mdBook configuration (#233 )

2025-12-18 09:56:37 +01:00

flake.nix

ci: add mdBook configuration (#233 )

2025-12-18 09:56:37 +01:00

Jenkinsfile

ci: host as lip.logos.co

2026-01-23 15:08:18 +01:00

LICENSE-APACHE-v2

Add/Update License Files (#314 )

2026-04-16 09:28:24 +03:00

LICENSE-MIT

Add/Update License Files (#314 )

2026-04-16 09:28:24 +03:00

Makefile

Chore: mirror blochain specs into github/mdbook (#347 )

2026-05-28 14:05:24 +03:00

package-lock.json

Chore/move repo into logos co (#312 )

2026-04-15 15:44:03 +03:00

package.json

Chore/move repo into logos co (#312 )

2026-04-15 15:44:03 +03:00

README.md

chore: split ift ts specs (#334 )

2026-05-11 18:05:13 +03:00

README.md

Logos LIP (Logos Improvement Proposals) Index

NOTE: This repo is still evolving while the LIP process is refined.

This repository contains specifications from the Messaging, Blockchain, Storage, and AnonComms components of the IFT portfolio. LIPs are Requests for Comments that document protocols, processes, and system interfaces in a consistent, reviewable format.

LIP process

This repository replaces the old rfc.vac.dev resource. Specs are maintained in Markdown here and progress through statuses such as raw, draft, stable, or deprecated. The process and lifecycle are defined in:

1/COSS: docs/research/draft/1/coss.md

Contributing

Open a pull request against this repo.
Add or update the LIP in the appropriate component folder.
Include status and category metadata in the header table.

If you are unsure where a document belongs, open an issue first and we will help route it.

Component indexes

Messaging: docs/messaging/README.md
Blockchain: docs/blockchain/README.md
Storage: docs/storage/README.md
AnonComms: docs/anoncomms/README.md
Research: docs/research/README.md

Local setup

Install mdBook (pick the version that matches your Rust toolchain).
Install Python dependencies if needed.

To install mdBook via Make:

make install

Build and serve

Run the generators before building or serving:

python scripts/run_runtime_generators.py
mdbook build

To serve locally:

make serve

Or run the commands directly:

python scripts/run_runtime_generators.py
mdbook serve -p 3000 -n 0.0.0.0

CI/CD

CI builds master and pushes to deploy-master branch, which is hosted at https://lip.logos.co/.
CI builds develop and pushes to deploy-develop branch, which is hosted at https://dev-lip.logos.co.dev/.

The hosting is done using Caddy server with Git plugin for handling GitHub webhooks.

Information about deployed build can be also found in /build.json available on the website.