annotations Documentation

1. Project Overview & Quickstart (square/annotations) Copy Chapter

Technical Documentation: square/annotations

ℹ️ Provenance: Multi-Tier Ingestion · CodeWiki Reference

annotations

Agent Skills & Rules Copy Section

• Discovered 21 agent rule(s) and prompt configurations.

--- METRICS ---

• Files Extracted: 1
• Estimated Token Budget: ~25 tokens
• Canonical Reference: https://codewiki.google/github.com/square/annotations

2. Official Technical Reference & Guides (square/square.github.io) Copy Chapter

File: README.md Copy Chapter

Square Open Source Portal

A simple, static portal which outlines our open source offerings. Intentionally
themed to look like a Square merchant page on the directory.

Development Copy Chapter

Run the site locally Copy Section

gem install bundler # first time only
bundle install # first time only
bundle exec jekyll serve

Update list of repos: Copy Section

pip install pystache requests pygithub3 # first time only
./generate.py

About the code Copy Chapter

Due to the use of absolute URLs in CSS files that are (essentially) out of our
control, the easiest way to develop is by running with Jekyll.

Repositories are listed in the repos.json file as a map of repository names
to a list of their categories. Invoking the generate.py script will update
the index.html page with the latest repos by using the index.mustache file
as a template.

Repository data is pulled via the GitHub API (e.g., website). By default the
script performs unauthenticated requests, so it's easy to run up against
GitHub's limit of 60 unauthenticated requests per
hour. To make authenticated
requests and work around the rate-limiting, add an entry for api.github.com to
your ~/.netrc file, preferably with a Personal Access Token from
https://github.com/settings/tokens

machine api.github.com
  login YourUsername
  password PersonalAccessToken

Images are loaded by convention from the repo_images/ directory. Ensure the
name is the same as the repo name in the repos.json file and has a .jpg
extension. Currently all images are rotated 10 degrees counter-clockwise to
break up the overwhelming horizontal and vertical visual lines on the page.

License Copy Chapter

Copyright 2021 Square Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

File: _config.yml Copy Chapter

auto: true
include: [".well-known"]

File: repos.json Copy Chapter

{
"repos": {
"Aardvark": ["iOS"],
"Ackbar": ["iOS"],
"android-times-square": ["Android"],
"anvil": ["Android", "Kotlin"],
"assertj-android": ["Android"],
"beancounter": ["Go"],
"border_patrol": ["Ruby"],
"cane": ["Ruby"],
"certigo": ["Go"],
"certstrap": ["Go"],
"Cleanse": ["iOS"],
"crossfilter": ["JavaScript"],
"cube": ["JavaScript"],
"cubism": ["JavaScript"],
"ETL": ["Ruby"],
"fdoc": ["Ruby"],
"field-kit": ["JavaScript"],
"ghostunnel": ["Go"],
"go-jose": ["Go"],
"gssh": ["Go"],
"JavaPoet": ["Java"],
"jetpack": ["Ruby"],
"jirafy": ["Other"],
"js-jose": ["JavaScript"],
"Keywhiz": ["Java"],
"KotlinPoet": ["Kotlin"],
"leakcanary": ["Android", "Kotlin"],
"LGTM": ["JavaScript"],
"metrics": ["Go"],
"moshi": ["Android", "Java"],
"okhttp": ["Android", "Java", "Kotlin"],
"okio": ["Android", "Java", "Kotlin"],
"p2": ["Other"],
"picasso": ["Android"],
"pollexor": ["Android", "Java"],
"PonyDebugger": ["iOS"],
"rack-servlet": ["Java"],
"rails-auth": ["Ruby"],
"retrofit": ["Android", "Java", "Kotlin"],
"seismic": ["Android"],
"shift": ["Other"],
"shuttle": ["Other"],
"spacecommander": ["iOS"],
"spoon": ["Android"],
"sqldelight": ["Android", "iOS", "Kotlin"],
"squalor": ["Go"],
"subzero": ["C", "Java", "Go"],
"SuperDelegate": ["iOS"],
"tape": ["Android"],
"toggle": null,
"Valet": ["iOS"],
"wire": ["Android", "Java", "Kotlin"],
"workflow": ["Android", "iOS", "Kotlin"]
},
"custom": [
{
"name": "es6-module-transpiler",
"homepage": "http://esnext.github.io/es6-module-transpiler/",
"html_url": "https://github.com/esnext/es6-module-transpiler",
"description": "Tomorrow’s JavaScript module syntax today",
"categories": ["JavaScript"]
}
]
}

File: requirements.txt Copy Chapter

pygithub3==0.5.1
pystache==0.5.4
requests==2.20.0

File: .travis.yml Copy Chapter

language: ruby
rvm:

• current

env:
global:
# speeds up installation of html-proofer

• NOKOGIRI_USE_SYSTEM_LIBRARIES=true

build and validate HTML files

more info at https://github.com/gjtorikian/html-proofer

script: bundle exec jekyll build #&& bundle exec htmlproofer ./_site --alt-ignore '/.*/'

cache:
directories:

• $TRAVIS_BUILD_DIR/tmp/.htmlproofer