diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 0000000..f77d01c
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,26 @@
+# Monthly pull requests to keep dependencies current. Each one runs the
+# docs-checks build, so a breaking update shows up as a failed check.
+#
+# Major versions are ignored: they need a person to read the release notes.
+# In particular MkDocs 2.0 drops the plugin and theme systems this site relies
+# on, so requirements.txt keeps mkdocs below 2 on purpose.
+version: 2
+updates:
+ - package-ecosystem: pip
+ directory: /
+ schedule:
+ interval: monthly
+ ignore:
+ - dependency-name: "*"
+ update-types: ["version-update:semver-major"]
+ groups:
+ docs-dependencies:
+ patterns: ["*"]
+
+ - package-ecosystem: github-actions
+ directory: /
+ schedule:
+ interval: monthly
+ groups:
+ github-actions:
+ patterns: ["*"]
diff --git a/.github/scripts/check_built_links.py b/.github/scripts/check_built_links.py
new file mode 100644
index 0000000..344fc38
--- /dev/null
+++ b/.github/scripts/check_built_links.py
@@ -0,0 +1,46 @@
+"""Check that every local link and image in the built site points at a real file.
+
+`mkdocs build --strict` checks Markdown links, but not paths written in raw
+HTML (e.g. `` in the equipment grids). Those
+paths are relative to the page's URL, and Spanish pages are served one
+folder deeper (/es/...), so a path copied from an English page breaks. This
+catches that.
+
+Usage: check_built_links.py [SITE_DIR] (default: site)
+Exits 1 if anything doesn't resolve.
+"""
+
+import posixpath
+import re
+import sys
+from pathlib import Path
+
+LINK = re.compile(r'(?:src|href)="([^"#?]+)')
+EXTERNAL = re.compile(r"^(?:[a-z][a-z0-9+.-]*:|//)", re.IGNORECASE)
+
+
+def main():
+ site = Path(sys.argv[1] if len(sys.argv) > 1 else "site")
+ broken = []
+ for page in sorted(site.rglob("*.html")):
+ url = "/" + page.relative_to(site).as_posix()
+ folder = posixpath.dirname(url) + "/"
+ for link in LINK.findall(page.read_text(encoding="utf-8", errors="ignore")):
+ if EXTERNAL.match(link):
+ continue
+ target = posixpath.normpath(posixpath.join(folder, link))
+ path = site / target.lstrip("/")
+ if not (path.is_file() or (path / "index.html").is_file()):
+ broken.append((url, link))
+
+ for url, link in broken:
+ print(f"{url}: {link} does not exist in the built site")
+ if broken:
+ print(f"\n{len(broken)} broken local link(s). Paths in raw HTML are relative to "
+ "the page's URL; pages under docs/es/ need one more '../' than English ones.")
+ sys.exit(1)
+ print("All local links and images resolve.")
+
+
+if __name__ == "__main__":
+ main()
diff --git a/.github/scripts/check_translations.py b/.github/scripts/check_translations.py
new file mode 100644
index 0000000..d7d7d0b
--- /dev/null
+++ b/.github/scripts/check_translations.py
@@ -0,0 +1,90 @@
+"""Report on how well docs/es keeps up with docs/en.
+
+Lists English pages with no Spanish version, Spanish pages that are still
+machine-drafted, and Spanish pages whose English page has changed since the
+Spanish one was last edited. On a pull request it also warns (as an inline
+annotation) when the PR edits an English page without touching its Spanish
+version.
+
+This only reports; it always exits 0 so it never blocks a merge.
+
+Usage: check_translations.py [BASE_REF]
+ BASE_REF the branch a pull request targets (e.g. origin/main), if any
+"""
+
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+EN = Path("docs/en")
+ES = Path("docs/es")
+DRAFT_MARKER = "TODO: machine-drafted"
+
+
+def git(*args):
+ result = subprocess.run(["git", *args], capture_output=True, text=True)
+ return result.stdout.strip()
+
+
+def last_commit_time(path):
+ stamp = git("log", "-1", "--format=%ct", "--", str(path))
+ return int(stamp) if stamp else 0
+
+
+def changed_files(base_ref):
+ if not base_ref:
+ return set()
+ return set(git("diff", "--name-only", f"{base_ref}...HEAD").splitlines())
+
+
+def main():
+ base_ref = sys.argv[1] if len(sys.argv) > 1 else ""
+ changed = changed_files(base_ref)
+
+ missing, drafts, stale = [], [], []
+ for en_page in sorted(EN.rglob("*.md")):
+ rel = en_page.relative_to(EN)
+ es_page = ES / rel
+ if not es_page.exists():
+ missing.append(rel)
+ continue
+ if DRAFT_MARKER in es_page.read_text(encoding="utf-8"):
+ drafts.append(rel)
+ if last_commit_time(en_page) > last_commit_time(es_page):
+ stale.append(rel)
+ if str(en_page) in changed and str(es_page) not in changed:
+ print(
+ f"::warning file={en_page}::This PR changes the English page but "
+ f"not {es_page}. Update the Spanish version too, or leave it for "
+ "a translator (it will show up as out of date)."
+ )
+
+ for rel in missing:
+ print(f"::warning file={EN / rel}::No Spanish version at {ES / rel}.")
+
+ lines = ["## Spanish translations", ""]
+ if not (missing or drafts or stale):
+ lines.append("Every English page has an up-to-date, reviewed Spanish version.")
+ for title, pages, note in [
+ ("No Spanish version", missing, "Spanish readers see the English page."),
+ ("English changed since the Spanish was last edited", stale,
+ "The Spanish page may be missing recent changes."),
+ ("Machine-drafted, awaiting review", drafts,
+ "Remove the notice and TODO comment once a fluent speaker has reviewed it."),
+ ]:
+ if pages:
+ lines += [f"### {title} ({len(pages)})", "", note, ""]
+ lines += [f"- `{rel}`" for rel in pages]
+ lines.append("")
+
+ report = "\n".join(lines) + "\n"
+ print(report)
+ summary = os.environ.get("GITHUB_STEP_SUMMARY")
+ if summary:
+ with open(summary, "a", encoding="utf-8") as f:
+ f.write(report)
+
+
+if __name__ == "__main__":
+ main()
diff --git a/.github/workflows/docs-checks.yml b/.github/workflows/docs-checks.yml
new file mode 100644
index 0000000..7b66a39
--- /dev/null
+++ b/.github/workflows/docs-checks.yml
@@ -0,0 +1,48 @@
+# Runs on every pull request (and on main after a merge).
+#
+# build: builds the site with `mkdocs build --strict`, which fails on
+# broken links between pages, links to missing headings, and
+# pages missing from the nav, then checks that image and link
+# paths written in raw HTML point at real files. This is the
+# check to require before merging.
+# translations: reports which Spanish pages are missing, machine-drafted, or
+# behind their English page. Report only; it never fails.
+name: Docs checks
+
+on:
+ pull_request:
+ push:
+ branches: [main]
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+concurrency:
+ group: docs-checks-${{ github.ref }}
+ cancel-in-progress: true
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-python@v5
+ with:
+ # Same version Read the Docs uses (.readthedocs.yaml)
+ python-version: "3.12"
+ cache: pip
+ cache-dependency-path: requirements.txt
+ - run: pip install -r requirements.txt
+ - run: mkdocs build --strict
+ - name: Check image and link paths in raw HTML
+ run: python .github/scripts/check_built_links.py site
+
+ translations:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ with:
+ # full history, to compare when each English and Spanish page last changed
+ fetch-depth: 0
+ - run: python .github/scripts/check_translations.py ${{ github.base_ref && format('origin/{0}', github.base_ref) || '' }}
diff --git a/.github/workflows/link-check.yml b/.github/workflows/link-check.yml
new file mode 100644
index 0000000..6de6e0a
--- /dev/null
+++ b/.github/workflows/link-check.yml
@@ -0,0 +1,78 @@
+# Checks every external link in the docs once a month.
+#
+# Outside sites break or move on their own schedule, so this doesn't run on
+# pull requests or block anything. When links are broken it opens an issue
+# (or updates the open one) labeled `broken-links`, and closes that issue
+# once everything passes again. Run it by hand from the Actions tab with
+# "Run workflow".
+#
+# Links that always fail for reasons we can't fix (login walls, bot
+# blocking) get an `--exclude ''` line in the args below.
+name: Link check
+
+on:
+ schedule:
+ - cron: "23 13 1 * *" # 1st of each month, 13:23 UTC
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ issues: write
+
+jobs:
+ links:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Check links
+ id: lychee
+ uses: lycheeverse/lychee-action@v2
+ with:
+ # Only http(s) links: links between pages are already checked by
+ # `mkdocs build --strict` in the docs-checks workflow. --root-dir
+ # lets lychee read root-relative image paths (/assets/...) as local
+ # files, which --scheme then skips.
+ # Excluded: the UniFi controller's device-adoption address (not a
+ # web page) and ProQuest (needs a library login).
+ args: >-
+ --no-progress
+ --scheme https --scheme http
+ --exclude-all-private
+ --root-dir ${{ github.workspace }}/docs
+ --max-retries 3 --retry-wait-time 10 --timeout 30
+ --accept 100..=103,200..=299,429
+ --exclude '^https?://unifi\.phillycommunitywireless\.org'
+ --exclude '^https?://search\.proquest\.com'
+ 'docs/**/*.md' README.md
+ output: lychee/out.md
+ fail: false
+
+ - name: Open, update or close the broken-links issue
+ env:
+ GH_TOKEN: ${{ github.token }}
+ GH_REPO: ${{ github.repository }}
+ EXIT_CODE: ${{ steps.lychee.outputs.exit_code }}
+ RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+ run: |
+ existing=$(gh issue list --label broken-links --state open --json number --jq '.[0].number // empty')
+ today=$(date -u +%F)
+
+ if [ "$EXIT_CODE" != "0" ]; then
+ {
+ echo "The monthly link check found links that don't work. Fix or replace them, or add a pattern to \`.lycheeignore\` if a site blocks automated checks but works in a browser."
+ echo
+ echo "Last checked $today ([run]($RUN_URL))."
+ echo
+ cat lychee/out.md
+ } > issue.md
+ if [ -n "$existing" ]; then
+ gh issue edit "$existing" --body-file issue.md
+ gh issue comment "$existing" --body "Checked again on $today; the list above is updated."
+ else
+ gh label create broken-links --color d93f0b --description "Found by the monthly link check" --force
+ gh issue create --title "Broken links in the docs" --label broken-links --assignee hawc2 --body-file issue.md
+ fi
+ elif [ -n "$existing" ]; then
+ gh issue close "$existing" --comment "All links passed on $today ([run]($RUN_URL))."
+ fi
diff --git a/README.md b/README.md
index 8c8f440..67d7668 100644
--- a/README.md
+++ b/README.md
@@ -1,100 +1,164 @@
# PCW Documentation
-Technical documentation and onboarding materials for Philly Community Wireless.
+Technical documentation and onboarding materials for Philly Community Wireless.
-Deploy previews via [Render](https://github.com/phillycommunitywireless/phillycommunitywireless/wiki/Deploy-Previews) — every pull request gets a live preview URL
+Access the docs here - https://docs.phillycommunitywireless.org
Built with [`mkdocs`](https://www.mkdocs.org) (via [Material Theme](https://squidfunk.github.io/mkdocs-material/))
-and deployed to [readthedocs.org](readthedocs.org)
+and deployed to [Read the Docs](https://readthedocs.org/projects/pcwdocs/).
[](https://docs.phillycommunitywireless.org/en/latest/?badge=latest)
-Access the docs here - https://docs.phillycommunitywireless.org
+Deploy previews via [Render](https://github.com/phillycommunitywireless/phillycommunitywireless/wiki/Deploy-Previews) — every pull request gets a live preview URL.
+
+# How the repo is laid out
+
+```
+docs/
+ en/ English pages (the default language)
+ es/ Spanish pages, mirroring en/ file for file
+ assets/ images, icons and config files shared by both languages
+ stylesheets/ extra CSS
+includes/
+ abbreviations.md hover definitions for acronyms, added to every page
+hooks/ small Python build hooks
+mkdocs.yml production settings and nav (what the live site shows)
+mkdocs.dev.yml local development nav, which also lists draft pages
+```
+
+A page's URL comes from its path under `docs/en/`: `docs/en/installations/solar.md` is served at `/installations/solar/`, and its Spanish version `docs/es/installations/solar.md` at `/es/installations/solar/`.
# Editing these docs
## Editing on GitHub
-After receiving access to the repository, edits can be made to the site's code directly from the GitHub web editor. Just find the file you'd like to edit (the filename will be the same as the page's slug) and click the pencil icon in the corner. Once you've completed your changes, scroll to the bottom, add a commit message, and click "Commit changes".
-
-**The `main` branch has merge protections enabled;** to propose edits, commit your changes to a new branch and open a pull request. This will generate a deploy preview using `Render` which will then be approved or denied.
+After receiving access to the repository, edits can be made directly from the GitHub web editor. Find the file you'd like to edit under `docs/en/` or `docs/es/` (the filename matches the end of the page's URL) and click the pencil icon in the corner. Once you've completed your changes, scroll to the bottom, add a commit message, and click "Commit changes".
+**The `main` branch has merge protections enabled;** to propose edits, commit your changes to a new branch and open a pull request. This will generate a deploy preview using Render, and a maintainer will review it.
## Editing locally
-This is only necessary if you need to see how the docs are specifically rendered on our live site. Any markdown editor should be able to preview the docs as they will appear on the site, without much deviation. If you want to make styling / structural changes to the site and/or its theme, this is also the way to do that.
+This is only necessary if you need to see exactly how the docs render on the live site, or you're making styling / structural changes to the site and its theme. Any markdown editor can preview the page content itself without much deviation.
-To make edits to the docs locally, you'll need to have a GitHub account and be listed as a contributor to the `phillycommunitywireless/docs` repository. You'll also need `git` and a markdown editor of your choice.
+To make edits locally, you'll need a GitHub account with contributor access to the `phillycommunitywireless/docs` repository, `git`, and a markdown editor of your choice.
-### 1) Configure Development Environment
+First, copy the repository to your machine:
-#### Docker
-* Download [Docker](https://www.docker.com), which should include Docker Compose on most machines.
-* Clone this repository - `https://github.com/phillycommunitywireless/docs.git`
-* Run `docker-compose up` inside the project directory:
```
-cd docs
-docker-compose up
+git clone https://github.com/phillycommunitywireless/docs.git
+cd docs
```
-* The mkdocs server will start up, and can be accessed at `http://localhost:8000`. Any changes made to the docs will automatically update the page.
-#### Virtual Environment
-If you need your development environment to integrate with other programs on your machine, e.g. for linting in a text editor, you'll need to set up a Python virtual environment with the necessary dependencies installed.
+If you already have it cloned, pull any new changes first with `git pull`.
-First things first: if you haven't already done so copy the docs repository to your local machine:
+### Option 1: Docker
+* Install [Docker](https://www.docker.com), which includes Docker Compose on most machines.
+* Run `docker compose up` inside the project directory.
+* The docs are served at `http://localhost:8000`, including draft pages. Any changes you save update the page automatically.
-```
-git clone https://github.com/phillycommunitywireless/docs.git
-cd docs
-```
+To preview the production site instead (drafts hidden, served by Caddy like the live server), uncomment the `APP_TAG=production` lines in `docker-compose.yml`.
-If you already have the repo cloned, you should pull any new changes to synchronize with the remote repo:
+### Option 2: Python virtual environment
+Use this if you want editor integrations such as linting, or don't want to install Docker. You'll need Python 3.
```
-git pull
+python3 -m venv .venv
+source .venv/bin/activate # on Windows: .venv\Scripts\activate
+pip install -r requirements.txt
```
-Make sure you have Python 3 and pip installed, and run the following commands:
+Then start the development server:
```
-# install the pipenv package
-pip install pipenv
-
-# create a virtual environment and install dependencies in it
-pipenv install -r requirements.txt
+mkdocs serve -f mkdocs.dev.yml
```
-Your dependencies are now installed in a virtual environment (usually located somewhere in your $HOME/.local/ folder). To active the environment on the command line, type `pipenv shell`. If you're using Visual Studio Code for editing, change the Python Interpreter setting to point to the path returned by pipenv which python.
+The docs are served at `http://127.0.0.1:8000`, with draft pages included. Run `mkdocs serve` without `-f mkdocs.dev.yml` to see only what the live site will show.
+
+If you're using Visual Studio Code, point its Python interpreter setting at `.venv`.
+## Adding a new page
+The site's navigation is listed by hand, so a new `.md` file won't appear in the menu until you add it there.
-### 2) Making edits to site data
+1. Create the file under `docs/en/`, in the folder that fits (e.g. `docs/en/installations/`). Start it with a title:
+ ```
+ ---
+ title: Your New Page
+ ---
-#### Edit markdown files
-You should see several markdown files in the docs/docs subfolder. These correspond to the pages on the main site. You can open and edit these files in a markdown editor of your choice!
+ # Your New Page
+ ```
+2. If the page isn't ready to publish, add it to `draft_docs` in `mkdocs.yml` as `/*/folder/your-new-page.md`. The `/*/` makes the line hide both the English and Spanish versions from the live site.
+3. Add it to the nav:
+ * **Draft:** add it only to the `nav:` in `mkdocs.dev.yml`, where it will eventually live. It will show up when you run the dev server but not on the live site.
+ * **Ready to publish:** add it to the `nav:` in `mkdocs.yml` (and `mkdocs.dev.yml`, if it isn't there already), and remove its line from `draft_docs`.
+4. Add a Spanish translation of the menu label under `nav_translations` in `mkdocs.yml`, and a Spanish version of the page at the same path under `docs/es/` (see below).
-#### Finalizing your changes
-Once you're confident in the changes you've made to the docs, you can push them back to the remote repo.
+## Spanish translations
+Every page in `docs/en/` should have a counterpart at the same path in `docs/es/`. If a Spanish page is missing, Spanish readers see the English page instead.
-**The `main` branch has merge protections enabled;** to propose edits, commit your changes to a new branch and open a pull request. This will generate a deploy preview using `Render` which will then be approved or denied.
+Some Spanish pages are machine-drafted placeholders that still need review by a fluent speaker. They start with a "Traducción preliminar" notice and a `` comment. When you've reviewed one, delete both. To find the ones left:
```
-git checkout -b your-branch-name
-git add .
-git commit -m "Add a message specifying what you changed"
-git push
+grep -rl "TODO: machine-drafted" docs/es
```
-If this is your first time pushing, you may need to run this instead:
+Use these terms so pages stay consistent. If a fluent reviewer decides a different term is better, change it here and on every page.
+
+| English | Spanish |
+|---|---|
+| access point (AP) | punto de acceso (AP); plural puntos de acceso (APs) |
+| mesh AP | AP de malla |
+| mesh / mesh network / mesh node | malla / red de malla / nodo de malla |
+| high site (PhillyWisper's tower) | sitio alto |
+| line of sight (LoS) | línea de visión (LoS) |
+| hub | hub (nodo central) on first use, then hub |
+| rooftop / roof | azotea / techo |
+| enclosure | caja |
+| GFCI outlet | tomacorriente GFCI |
+| PoE / PoE injector | PoE (alimentación a través de Ethernet) / inyector PoE |
+| non-penetrating roof mount (NPRM) | soporte de techo no penetrante (NPRM) |
+| uplink | enlace ascendente (uplink) |
+| computer | computadora (not ordenador) |
+| Wi-Fi (in prose) | wifi |
+| rowhome | casa en hilera |
+| multi-dwelling unit (MDU) | edificio multifamiliar (MDU) |
+| building assessment | evaluación del edificio |
+| antenna host | anfitrión de antena |
+| installation / install | instalación / instalar |
+| solar node | nodo solar |
+
+Address readers as *usted* (e.g. "Seleccione", "Conéctese"). Keep acronyms in English (AP, LoS, PoE, MDU) so the hover definitions work, and keep English software labels as they appear on screen, with a Spanish gloss in parentheses the first time.
+
+Hover definitions for acronyms come from `includes/abbreviations.md` on English pages and `includes/abbreviations.es.md` on Spanish pages. Keep the two files' terms in sync.
+
+Anchor links (`page.md#some-heading`) use the heading text, so a link into a Spanish page must use the Spanish heading's anchor, e.g. `configure-computer.md#configurar-una-direccion-ip-estatica`.
+
+Known limitation: the dev server shows Spanish draft pages in the menu, but opening one gives a 404. The translation plugin builds the Spanish site separately and always leaves drafts out. Preview the English draft instead.
+
+## Links
+Links to other pages in the docs should point at the `.md` file, relative to the current page, so mkdocs can check them when it builds.
+
+
+
+Before opening a pull request, you can check for broken internal links (including links to headings that don't exist) by running:
```
-git push --set-upstream origin your-branch-name
+mkdocs build --strict
```
-#### Adding new files
-To add a new page, simply add a new `.md` file to the desired parent directory; your new page will appear as child item of the directory.
-
-
+## Automated checks
+These run on GitHub; you don't need to set anything up.
-
+* **Docs checks** (`.github/workflows/docs-checks.yml`) runs on every pull request:
+ * **build** runs `mkdocs build --strict` and fails if a link points at a missing page or heading. It also fails if an image or link written in raw HTML (like ``) points at a file that doesn't exist. Raw HTML paths are relative to the page's URL, so pages under `docs/es/` need one more `../` than their English versions. Fix these before merging.
+ * **translations** never fails. Its summary (on the pull request's "Checks" tab) lists Spanish pages that are missing, machine-drafted, or behind their English page. If your pull request changes an English page but not its Spanish version, it leaves a warning on the file.
+* **Link check** (`.github/workflows/link-check.yml`) tests every external link on the 1st of each month. If any are broken it opens an issue labeled `broken-links` (or updates the open one), and closes it once they all pass. To run it now, open the repo's Actions tab, choose "Link check" and click "Run workflow". If a site works in a browser but always fails the check, add an `--exclude` line for it in that file.
+* **Dependabot** (`.github/dependabot.yml`) opens a monthly pull request with minor dependency updates. It skips major versions on purpose, since MkDocs 2.0 would break this site.
-#### Updating links
-Links to other pages on the doc should be suffixed by `.md` to avoid warnings at runtime.
+## Finalizing your changes
+Once you're confident in your changes, push them to a new branch and open a pull request:
-
+```
+git checkout -b your-branch-name
+git add .
+git commit -m "Add a message specifying what you changed"
+git push --set-upstream origin your-branch-name
+```
diff --git a/docs/en/device-configuration/configure-ap-mesh.md b/docs/en/device-configuration/configure-ap-mesh.md
index 7db0345..9c82165 100644
--- a/docs/en/device-configuration/configure-ap-mesh.md
+++ b/docs/en/device-configuration/configure-ap-mesh.md
@@ -70,7 +70,7 @@ We need to connect the device to our computer and determine its IP address, whil
!!! info ""
Normally, any device on your network will receive an IP address via the Dynamic Host Configuration Protocol, or DHCP. This ensures that your router knows which device it is communicating with on your network. Although Unifi APs reset to `192.168.1.20`, if the AP has already been configured it may receive a different IP address.
-The Unifi mesh APs should automatically reset to `192.168.1.20` so you can first try Step 2 and see if the `ssh` command works.
+The Unifi mesh APs should automatically reset to `192.168.1.20` so you can first skip ahead to [Step 3](#3-connect-to-the-ap-using-ssh) and see if the `ssh` command works.
If the mesh AP's IP address isn't `192.168.1.20`, there are two ways to find the IP address:
diff --git a/docs/en/device-configuration/configure-computer.md b/docs/en/device-configuration/configure-computer.md
index e2fce50..f2c8cb2 100644
--- a/docs/en/device-configuration/configure-computer.md
+++ b/docs/en/device-configuration/configure-computer.md
@@ -88,7 +88,7 @@ _Begin these steps with the AP not connected to your computer via an ethernet po
3. Connect the ap to your machine or adapter and run `arp -a | grep -v incomplete` again. The difference between this and the previous grep output should be the AP. Note the IP address and MAC address.
-4. To confirm that the AP has a route to the internet, you can run the same commands as specified in step 5 of the Ubuntu instructions above (ssh, ping, etc.).
+4. To confirm that the AP has a route to the internet, SSH into it using the IP address you noted (see [Connect to the AP using SSH](configure-ap-mesh.md#3-connect-to-the-ap-using-ssh)) and `ping` an outside address from there.
Note: These instructions were developed on a MacBook running Catalina, version 10.15.7.
diff --git a/docs/en/device-configuration/configure-edgerouter-x.md b/docs/en/device-configuration/configure-edgerouter-x.md
index 0b0bbc0..8998b62 100644
--- a/docs/en/device-configuration/configure-edgerouter-x.md
+++ b/docs/en/device-configuration/configure-edgerouter-x.md
@@ -144,7 +144,7 @@ This method allows the ERX to connect to the Internet through your home router.
11. Set up the DNS address as 1.1.1.1.
-12. Reset your computer's network settings; remove the static IP set in [Step 2](#2-configure-your-network-settings), and reset your connection settings to Dynamic.
+12. Reset your computer's network settings; remove the static IP set in [Step 2](#2-configure-your-network-settings_1), and reset your connection settings to Dynamic.
13. Connect to the ERX again and log in with the PCW username and password.
diff --git a/docs/en/for-network-users/connect-to-the-network.md b/docs/en/for-network-users/connect-to-the-network.md
index f162c8f..922aad9 100644
--- a/docs/en/for-network-users/connect-to-the-network.md
+++ b/docs/en/for-network-users/connect-to-the-network.md
@@ -1,7 +1,23 @@
# Connecting to the Network
+PCW's free Wi-Fi is available in the areas shown on our [network map](https://phillycommunitywireless.org/networkmap). To ask about getting coverage for your building, see [Get connected](https://phillycommunitywireless.org/getconnected) on our main site.
+
+## Connect
+
You can connect to PCW’s free Wi-Fi the same as any other Wi-Fi network.
* Go to your device’s Wi-Fi settings
-* Browse the list of available Wi-Fi networks for “PhillyCommunityWireless”
-* Select “PhillyCommunityWireless” and click “connect”.
+* Browse the list of available Wi-Fi networks for “Philly Community Wireless”
+* Select “Philly Community Wireless” and click “connect”.
+
+Streaming devices and smart TVs (Chromecast, Roku, Firestick, etc.) may not work consistently on the public network. See [Configure IoT Devices](configure-IoT.md) for a network set up for them.
+
+## If you can't connect
+
+* **You don't see “Philly Community Wireless” in the list.** Check the [network map](https://phillycommunitywireless.org/networkmap) to make sure you're in a coverage area. Wi-Fi signals weaken as they pass through walls, so try moving closer to a window or to where the access point is mounted.
+* **You're connected, but pages won't load.** Turn your device's Wi-Fi off and back on. If that doesn't work, “forget” the network in your Wi-Fi settings, then connect to it again.
+* **It still isn't working.** Email us at info@phillycommunitywireless.org. Tell us where you are (an address or nearest intersection), what device you're using, and what happens when you try to connect.
+
+## Using public Wi-Fi safely
+
+Like any public Wi-Fi network, PCW's network is shared with other people nearby. When you enter passwords or personal information, check that the website's address starts with `https://` (most browsers show a padlock icon next to it).
diff --git a/docs/es/device-configuration/configure-ap-mesh.md b/docs/es/device-configuration/configure-ap-mesh.md
index 86de276..5aac952 100644
--- a/docs/es/device-configuration/configure-ap-mesh.md
+++ b/docs/es/device-configuration/configure-ap-mesh.md
@@ -1,85 +1,160 @@
---
-Title: Configurar AP Mesh
-
+title: Configurar APs Unifi
---
-Esta guía lo guiará a través de la configuración de una malla de punto de acceso Ubiquiti para que pueda ser adoptada por la red PCW.
-## Hardware requerido
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../device-configuration/configure-ap-mesh/) es la referencia.
+
+
+
+ El UAP-AC-M, también conocido como 'orejas de conejo'
+
+
+Esta guía le explica paso a paso cómo configurar un Ubiquiti Access Point AC Mesh ("orejas de conejo"). El proceso consiste en los siguientes pasos:
+
+- Encender el Unifi AP AC Mesh y restablecerlo a la configuración de fábrica
+- Conectar el dispositivo a su computadora y asegurarse de que tenga una ruta a Internet
+- Identificar la dirección IP del AP y usar `ssh` para conectarse al dispositivo: `ssh ubnt@192.168.1.20`
+- Indicarle al dispositivo la URL de nuestro controlador Unifi: `sudo set-inform http://unifi.phillycommunitywireless.org:8080/inform`
+- Adoptar el dispositivo desde la interfaz del controlador
+- Configurar el dispositivo y actualizar su firmware
-| Item | Purpose |
+## Lo que necesitará
+
+| Artículo | Para qué sirve |
| -------------------------------------------- | ------------------------------------------------- |
-| Unidad de malla AP | Unidad a configurar |
-| Inyector PoE (comes with AP) | |
-| Cable Ethernet | Uno alimenta el punto de acceso, el otro proporciona el enlace de datos a la computadora. |
-| Adaptador Ethernet USB | Si el ordenador no tiene puerto ethernet |
-| Ordenador | Realizar configuración remota |
-| Cable de regleta/alargador | |
-| Paperclip (or other thin item) | Realizar un restablecimiento de fábrica |
+| Punto de acceso Unifi | La unidad que se va a configurar |
+| Inyector PoE (alimentación a través de Ethernet), incluido con el AP | Suministra electricidad al AP |
+| 2 cables Ethernet | Uno alimenta el AP y el otro proporciona el enlace de datos a la computadora |
+| Adaptador USB a Ethernet | Si su computadora no tiene puerto Ethernet |
+| Computadora con MacOS o Linux | Para realizar la configuración remota |
+| Tomacorriente de pared | |
+| Clip (u otro objeto delgado) | Para restablecer la configuración de fábrica |
+
+
+
+## Pasos de configuración
+
+
+### 1. Encienda el dispositivo y restablezca la configuración de fábrica
+
+1. Conecte el inyector PoE a un tomacorriente o a una regleta de enchufes.
+2. Conecte el puerto `POE` del inyector al AP de malla con un cable Ethernet. Debería ver que se enciende una luz blanca.
+
+
+
+ El inyector va entre el tomacorriente de pared y el AP. Un cable lleva electricidad y datos al AP; el otro es el enlace de datos de regreso a su computadora o router.
+
+
+!!! info ""
+
+ La luz será azul si el dispositivo tiene una configuración anterior. No se preocupe: a continuación vamos a restablecer el dispositivo a la configuración de fábrica.
+
+
+
+
+
+Los AP de malla han tenido un comportamiento inesperado incluso recién sacados del empaque, por lo que se recomienda restablecerlos a la configuración de fábrica antes de continuar.
+
+1. Con el clip, presione el botón de reinicio (reset) que está en la parte inferior del AP de malla hasta que haga clic.
+2. Manténgalo presionado durante 5 segundos.
+3. La luz de estado del AP debería parpadear y luego apagarse mientras el dispositivo se reinicia. Cuando vuelva a encenderse, debería quedar en blanco fijo, lo que indica que el restablecimiento se completó correctamente.
+4. Para obtener más información sobre las luces de estado, consulte [Patrones de color de los LED de los dispositivos UniFi](troubleshoot-devices.md#indicadores-led-de-estado-de-los-ap-unifi)
+
+Nota: El AP de malla puede tardar unos minutos en iniciarse después de conectarlo o restablecerlo, así que espere hasta que la luz de estado esté en blanco fijo.
+
+
+### 2. Conecte el AP a su computadora
+
+Necesitamos conectar el dispositivo a nuestra computadora y averiguar su dirección IP, y al mismo tiempo asegurarnos de que también tenga una ruta a Internet.
+
+!!! info ""
+ Normalmente, cualquier dispositivo en su red recibe una dirección IP mediante el protocolo de configuración dinámica de host (Dynamic Host Configuration Protocol, o DHCP). Esto permite que su router sepa con qué dispositivo se está comunicando en su red. Aunque los AP Unifi se restablecen a `192.168.1.20`, si el AP ya se ha configurado antes, es posible que reciba otra dirección IP.
+
+Los AP de malla Unifi deberían restablecerse automáticamente a `192.168.1.20`, así que primero puede pasar directamente al [paso 3](#3-conectese-al-ap-por-ssh) y ver si funciona el comando `ssh`.
+
+Si la dirección IP del AP de malla no es `192.168.1.20`, hay dos formas de encontrarla:
+
+
+
Conectarlo al router local
+
Conectarlo a su computadora
+
+
+Por lo general, usamos la opción b): conectar el AP directamente a nuestra computadora.
+
+#### 2a) Si tiene acceso físico a su router wifi
+
+1. Conecte el puerto `LAN` del inyector PoE directamente a un puerto Ethernet de su router.
+2. El AP obtendrá la dirección IP `192.168.1.20` de su router. [Pase directamente al paso de SSH](#3-conectese-al-ap-por-ssh).
+
+#### 2b) Si no tiene acceso a su router
+
+1. Conecte el puerto `LAN` del inyector a su computadora, usando el adaptador USB a Ethernet si no tiene un puerto Ethernet.
+2. Asegúrese de que su computadora esté conectada al wifi.
+3. La dirección IP de su computadora debe ser estática para que usted pueda ver el AP y conectarse a él por `ssh`.
+4. Siga las instrucciones de [Configurar una IP estática en su computadora](configure-computer.md#configurar-una-direccion-ip-estatica) para establecer su dirección IP.
+5. También puede seguir las instrucciones de [Compartir una conexión wifi por Ethernet](configure-computer.md#compartir-una-conexion-wifi-por-ethernet) para compartir la conexión inalámbrica de su computadora con el AP.
+6. Para encontrar la dirección IP del AP, o si la conexión SSH se queda colgada, pruebe ejecutar `arp -a` para encontrar el AP.
+
+
+### 3. Conéctese al AP por SSH
+
+!!! info ""
+ `ssh`, o Secure Shell, es un protocolo que se usa para proteger las comunicaciones en una red mediante criptografía de clave pública. Usamos `ssh` para conectarnos a los AP desde la línea de comandos para configurarlos y adoptarlos.
-
+1. En la terminal, ejecute el comando `ssh ubnt@192.168.1.20`, o reemplace la dirección IP predeterminada por la que copió.
+2. Es posible que vea "`The authenticity of host [...] can't be established`" (no se puede comprobar la autenticidad del host). Escriba "yes" y presione Enter.
+3. Cuando se le pida la contraseña, escriba `ubnt`.
+4. Ahora debería estar conectado al AP de malla.
-## Pasos de instalación
+ 
-### Establecer IP estática en el equipo
+!!! warning ""
-Instrucciones para Mac (otros sistemas operativos por determinar)
+ Si recibe el error `Host key verification failed`, tendrá que editar su archivo `known_hosts`.
+ 1. La forma más fácil es ejecutar el siguiente comando (al menos en Ubuntu funciona): `sudo ssh-keygen -f "/root/.ssh/known_hosts" -R "192.168.1.20"`
+ 1. Otra opción es abrir `~/.ssh/known_hosts` con `vim`, `nano` o el editor de texto que prefiera.
+ 2. Elimine la línea que comienza con `192.168.1.20` (se verá parecida a `192.168.1.20 ssh-rsa AAAAB3NzaC1yc2E...`) y guarde el archivo.
-1. Abra `System Preferences` > `Network`.
-2. Seleccione la conexión Ethernet que tiene con la unidad de malla AP. 
-3. Cambie el valor de `Configure IPv4` a `Manually`.
- 
-4. Establezca la dirección IP en `192.168.1.29` (aunque la mayoría de los valores deberían funcionar aquí).
-5. Establezca la máscara de subred a `255.255.255.0`
- 
-6. Haga clic en `Apply`
-### Conecte la unidad de malla AP.
+### 4. Adopte el AP de malla
-1. Conecte el inyector PoE a una toma de corriente o a una regleta.
-2. Conecte el puerto `POE` del inyector a la unidad de malla AP con un cable ethernet.
-3. Conecte el puerto `LAN` del inyector al ordenador, utilizando el adaptador Ethernet USB si no dispone de un puerto Ethernet.
- 
- 
+!!! info ""
-### Restablecimiento de fábrica de la unidad de malla AP.
+ Necesitará acceso a la interfaz del controlador Unifi de PCW para completar este paso.
-Las unidades de malla AP han tenido un comportamiento inesperado incluso fuera de la caja, por lo que se recomienda reiniciarlas de fábrica antes de continuar.
+1. Desde su sesión de `ssh`, ejecute el comando `sudo set-inform http://unifi.phillycommunitywireless.org:8080/inform`. Esto enviará un mensaje por Internet a nuestro controlador para avisarle que el dispositivo quiere ser adoptado.
-1. Con el clip, pulse el botón de restablecimiento situado en la parte inferior de la unidad de malla AP hasta que haga clic.
-2. Mantenga pulsado durante 15 segundos.
-3. Una vez que la luz de estado de la unidad de malla AP ha destellado y se ha apagado, el dispositivo se ha restablecido.
+ !!! warning ""
-### Conecte a la unidad de malla AP.
+ Si el comando se queda colgado aquí, lo más probable es que su AP no tenga una ruta a Internet. [Regrese al paso de conexión](#2-conecte-el-ap-a-su-computadora) y asegúrese de que su configuración siga esas instrucciones.
-1. Abra un símbolo del sistema
-2. Si se ha conectado previamente a una unidad de malla de AP, tendrá que editar el archivo de `known_hosts` , o obtendrá un error de`Host key verification failed` error.
- 1. Abra `~/.ssh/known_hosts` con `vim`, `nano`, o el editor de texto que desee.
- 2. Elimine la línea que comienza por `192.168.1.20` (tendrá un aspecto similar a `192.168.1.20 ssh-rsa AAAAB3NzaC1yc2E...`), y guarde el archivo.
-3. Ejecute el comando `ssh ubnt@192.168.1.20`
-4. Puede ver la alerta:
+2. Abra en su navegador el portal Hostifi del controlador Unifi y vaya a la lista de dispositivos. El AP debería aparecer en la lista de dispositivos en espera de adopción.
+3. Presione `Adopt` (adoptar) para adoptar el AP de malla.
+4. La adopción puede tardar un rato. Pruebe actualizar el portal Hostifi, el navegador o ambos.
+5. Se le pedirá que elija un grupo (Group) para el AP. Elija All APs (todos los APs) y presione Save (guardar).
+6. Regrese al Dashboard (panel principal) para ver si el dispositivo ya se adoptó.
+7. Si el dispositivo se queda colgado durante la adopción, pruebe la opción Forget (olvidar) y vuelva a ejecutar el comando `set inform`.
- The authenticity of host '192.168.1.20 (192.168.1.20)' can't be established.
- RSA key fingerprint is SHA256:oUG6ABM3uor6lfBpJFcnHWyhhPnCrIx2Jf0U1+UAg4g.
- Are you sure you want to continue connecting (yes/no/[fingerprint])?
+### 5. Configure el AP y establezca la versión del firmware
- Presione sí para continuar.
-5. Cuando se le solicite la contraseña, escriba `ubnt`.
-6. Ahora debe estar conectado a la unidad de malla AP.
- 
+1. Cambie la configuración para agregar su nombre y un número a cada dispositivo que configure. El equipo de administración volverá a etiquetar los dispositivos al instalarlos.
+2. Para actualizar el firmware desde el controlador, vaya al dispositivo y abra Settings (configuración). En Manage (administrar), busque el campo Location URL (URL de ubicación), pegue el enlace de la versión del firmware y presione Update (actualizar).
+ * Las URL del firmware están disponibles en el sitio de [Unifi](https://ui.com/download/unifi) (en inglés)
-### Adopte AP Mesh Unit
+Puede ajustar otras opciones del dispositivo en la configuración, pero es mejor dejar la configuración de radio con los valores predeterminados hasta que el dispositivo esté instalado en la red.
-Necesitará acceso al portal Philly Community Wireless HostiFi para completar este paso.
+También puede establecer la versión del firmware mientras está conectado al dispositivo por `ssh`:
-1. De su `ssh` , ejecute el comando `set-inform http://unifi.phillycommunitywireless.org:8080/inform`.
- * Esto alertará al controlador HostiFi de que la unidad de malla AP desea ser adoptada.
-2. Abra el portal HostiFi en el explorador y desplácese a la lista de dispositivos.
-3. La unidad de malla AP debe aparecer en la lista de dispositivos en espera de adopción.
-4. Pulse `Adopt` para adoptar la unidad de malla AP.
+1. Mientras está conectado al dispositivo por `ssh`, escriba `upgrade $url_to_firmware_version`
+2. Se desconectará del dispositivo. Espere a que se reinicie y la luz esté en blanco fijo (puede hacer `ping` a la dirección IP para comprobar si ya está en línea, o simplemente intentar conectarse por SSH) y luego vuelva a conectarse por `ssh`.
+3. Si se queda colgado, pruebe cancelar y volver a ejecutar el comando.
+4. Puede comprobar que el firmware se actualizó mirando el encabezado de la línea de comandos, que muestra la versión del firmware, por ejemplo "UBNT-BZ.v4.3.20#".
-## Solución de problemas
+!!! warning ""
-1. Computadora no reconoce la unidad de malla AP en la configuración de red o el comando`ssh` falla.
- * La unidad de malla AP puede tardar unos minutos en iniciarse después de enchufarla, por lo que espere hasta que la luz de estado se ilumine en blanco y vuelva a intentarlo.
-2. ¿Qué significa este patrón de luces de estado?
- * [LED Color Patterns for UniFi Devices](https://help.ui.com/hc/en-us/articles/204910134-UniFi-LED-Color-Patterns-for-UniFi-Devices)
+ La actualización del firmware suele quedarse colgada. Recomendamos actualizar el firmware desde el controlador Unifi.
diff --git a/docs/es/device-configuration/configure-computer.md b/docs/es/device-configuration/configure-computer.md
new file mode 100644
index 0000000..1e8b560
--- /dev/null
+++ b/docs/es/device-configuration/configure-computer.md
@@ -0,0 +1,118 @@
+---
+title: Configurar una IP estática
+---
+
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../device-configuration/configure-computer/) es la referencia.
+
+Esta página explica cómo configurar su computadora para poder conectarse a los dispositivos de red. Veremos cómo establecer una dirección IP estática y cómo compartir la conexión a Internet con otras computadoras.
+
+# Configurar una dirección IP estática
+Esta sección contiene instrucciones para configurar el adaptador Ethernet de su computadora para que use una dirección IP estática en la subred 192.168.1.\*. Este paso es necesario para conectarse a ciertos dispositivos de red por Ethernet, y se usa en nuestras instrucciones de configuración del [EdgeRouter X](configure-edgerouter-x.md) y del [AP de malla](configure-ap-mesh.md).
+
+Elija el sistema operativo de su computadora:
+
+* **[MacOS](#macos)**
+* **[Ubuntu](#ubuntu)**
+* **[Windows](#windows)**
+
+## MacOS
+
+1. Abra `System Preferences` (Preferencias del Sistema) > `Network` (Red).
+2. Seleccione la conexión Ethernet que tiene con el dispositivo que desea configurar.
+ 
+3. Cambie el valor de `Configure IPv4` (configurar IPv4) a `Manually` (manualmente).
+ 
+4. Establezca la dirección IP (IP Address) en `192.168.1.2`.
+5. Establezca la máscara de subred (Subnet Mask) en `255.255.255.0`
+ 
+6. Haga clic en `Apply` (aplicar)
+
+## Ubuntu
+
+_Estas instrucciones solo se han probado en Ubuntu 20.04._
+
+1. Abra `Settings` (Configuración) > `Network` (Red).
+2. En la sección "wired" (cableada), haga clic en el signo de más para crear un nuevo perfil de configuración. Nombre el perfil "Static IP" o como usted prefiera.
+ 
+3. En la pestaña **IPv4**, elija "Manual".
+4. Establezca el campo Address (dirección) en `192.168.1.2`
+5. Establezca la Netmask (máscara de red) en: `255.255.255.0`
+ (Deje Gateway (puerta de enlace) vacío, y DNS/Routes (rutas) en Automatic (automático))
+ 
+6. Haga clic en "add" (agregar); debería ver aparecer el perfil en su configuración. Selecciónelo cuando esté conectado para activar la configuración de IP estática.
+
+## Windows
+
+1. Abra `Network Connections` (Conexiones de red) (escriba 'view network connections' en la búsqueda de Windows)
+2. Haga clic derecho en el adaptador de red deseado para abrir el menú contextual y luego haga clic en 'Properties' (Propiedades)
+3. En el menú '(Adapter Name) Properties', haga doble clic en 'Internet Protocol Version 4 (TCP/IPv4)', o selecciónelo y luego haga clic en 'Properties'. 
+4. En el menú 'Internet Protocol Version 4 (TCP/IPv4) Properties', seleccione 'Use the following IP address' (Usar la siguiente dirección IP):
+5. Establezca la dirección IP (IP Address) en `192.168.1.2`
+6. Establezca la máscara de subred (Subnet mask) en `255.255.255.0`
+
+7. Haga clic en `OK`
+
+## Detalles
+Estos pasos usan `192.168.1.2` como IP estática, pero puede ser cualquier dirección dentro del rango `192.168.1.0/24` (`.0-.255`) excepto `.0` (la red), `.1` (la puerta de enlace), `.20` (la IP predeterminada del AP de malla) y `.255` (difusión o *broadcast*).
+
+# Compartir una conexión WiFi por Ethernet
+Esta sección describe cómo conectar un dispositivo a su computadora por Ethernet y compartir con ese dispositivo la conexión a Internet que ya tiene su computadora. En otras palabras, su computadora funcionará como puerta de enlace (*gateway*) y el dispositivo conectado podrá enviar paquetes a Internet a través de su computadora.
+
+Esto es útil cuando necesita que un dispositivo tenga acceso a Internet mientras está conectado en red con su computadora, pero usted no tiene acceso a su router. Lo usamos como una opción en nuestras instrucciones de configuración del [AP de malla Unifi](configure-ap-mesh.md).
+
+Elija el sistema operativo de su computadora:
+
+**[Ubuntu](#ubuntu_1)**
+**[MacOS](#macos_1)**
+**[Windows](#windows_1)**
+
+## Ubuntu
+1. Abra `Settings` (Configuración) > `Network` (Red).
+
+2. En la sección `Wired` (cableada), haga clic en el signo de más para crear un nuevo perfil de configuración. Nombre el perfil "Shared" o como usted prefiera.
+
+3. En la pestaña **IPv4**, elija "Shared to other computers" (compartida con otras computadoras). Haga clic en Apply (aplicar). Su computadora ahora debería estar conectada en red con el AP. 10.42.0.0/24 es la subred predeterminada que usa Ubuntu para esta configuración, pero no hay garantía de que su computadora use esa subred. Si el siguiente paso no devuelve resultados, ejecute `ip address` o `ifconfig` y busque allí la IP de su interfaz Ethernet (normalmente `eth0`).
+
+4. Abra una terminal. Escriba lo siguiente para escanear los dispositivos en ese rango de IP:
+
+ nmap -sn 10.42.0.0/24 | grep report
+
+ Debería ver dos líneas que empiezan con "`nmap scan report`". Busque la línea con una dirección IP que no termine en "`.1`" y copie esa dirección IP.
+
+Si el comando nmap se queda colgado, también puede probar las instrucciones de Mac OS en Ubuntu Linux y deberían funcionar bien.
+
+## MacOS
+_Comience estos pasos con el AP desconectado de su computadora (sin conectarlo a un puerto o adaptador Ethernet)._
+
+1. Abra `Sharing` (Compartir) desde el menú `System Preferences` -> seleccione `Internet Sharing` (Compartir Internet) en la lista de la izquierda -> seleccione las interfaces para las que desea activar el uso compartido -> marque la casilla junto a `Internet Sharing` para activarlo -> aparecerá un cuadro de advertencia; haga clic en `Start` (iniciar).
+
+2. Ejecute `arp -a | grep -v incomplete` para mostrar la correspondencia entre direcciones IP y direcciones MAC de los dispositivos de su red.
+
+3. Conecte el AP a su computadora o adaptador y ejecute `arp -a | grep -v incomplete` de nuevo. La diferencia entre este resultado y el del grep anterior debería ser el AP. Anote la dirección IP y la dirección MAC.
+
+4. Para confirmar que el AP tiene una ruta hacia Internet, conéctese a él por SSH usando la dirección IP que anotó (consulte [Conéctese al AP por SSH](configure-ap-mesh.md#3-conectese-al-ap-por-ssh)) y, desde allí, haga `ping` a una dirección externa.
+
+Nota: Estas instrucciones se elaboraron en una MacBook con Catalina, versión 10.15.7.
+
+## Windows
+*Comience estos pasos conectando el AP a un inyector PoE, y conectando el puerto LAN del inyector PoE al puerto Ethernet de su computadora.*
+
+1. Abra el menú 'Settings' (Configuración) y luego haga clic en 'Network and Internet' (Red e Internet)
+
+2. En 'Advanced Network Settings' (Configuración de red avanzada), haga clic en 'Change Adapter Options' (Cambiar opciones del adaptador)
+
+3. En la ventana emergente, haga clic derecho en la interfaz por la que está conectado a Internet (probablemente será 'Wifi' o 'Ethernet') y luego haga clic en 'Properties'
+
+4. En la segunda ventana emergente, haga clic en la pestaña 'Sharing' (Uso compartido).
+
+5. En 'Internet Connection Sharing' (Conexión compartida a Internet), seleccione 'Allow other network users to connect through this computer's Internet connection' (Permitir que los usuarios de otras redes se conecten a través de la conexión a Internet de esta computadora).
+
+6. En el menú desplegable, seleccione la interfaz a la que está conectado el AP/inyector PoE.
+
+7. Haga clic en 'OK'
+
+8. Ejecute `arp -a` y busque la dirección MAC del AP en la tabla ARP.
+
+Nota: estas instrucciones se elaboraron en Windows 10.
diff --git a/docs/es/device-configuration/configure-edgerouter-ansible.md b/docs/es/device-configuration/configure-edgerouter-ansible.md
new file mode 100644
index 0000000..8758818
--- /dev/null
+++ b/docs/es/device-configuration/configure-edgerouter-ansible.md
@@ -0,0 +1 @@
+# Configuración automatizada con Ansible
diff --git a/docs/es/device-configuration/configure-edgerouter-x.md b/docs/es/device-configuration/configure-edgerouter-x.md
index f10de7c..ba40dfa 100644
--- a/docs/es/device-configuration/configure-edgerouter-x.md
+++ b/docs/es/device-configuration/configure-edgerouter-x.md
@@ -1,53 +1,166 @@
---
-Title: Configurar ERX Router
-
+title: Configurar EdgeRouter X
---
-# Configurar ERX Router
-
-Esta guía le guiará a través de la configuración de un Ubiquiti EdgeRouter X.
-## Hardware requerido
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../device-configuration/configure-edgerouter-x/) es la referencia.
-* Router e cable de alimentación
-* Tranque cable
-* Computador
-* Adaptador Ethernet USB (si la computadora no tiene puerto Ethernet)
+# Configurar EdgeRouter X
+Esta guía le explica paso a paso cómo configurar un Ubiquiti EdgeRouter X.
-
+## Configuración con LiteBeam
+Este método configura el ERX para usarlo en un sitio de instalación de PCW, con conexión a Internet a través de una LiteBeam.
-## Pasos de instalación
+### Hardware requerido
+- [Router ERX](https://store.ui.com/collections/operator-edgemax-routers/products/edgerouter-x) y su cable de alimentación
+- Cable Ethernet
+- Computadora
+- Adaptador Ethernet USB (si la computadora no tiene puerto Ethernet)
-### Establecer IP estática en el equipo
-
-Ver [Configurar una IP estática](configure-computer.md)
+
+
+ Materiales para configurar el ERX: configuración 'normal'
+
-### Conecte el ERX
+### 1) Conecte el ERX
-El ERX tiene cinco puertos Ethernet. `eth0` recibe alimentación por PoE y es el puerto por el que se
-configura el router; `eth4` es el puerto WAN y el que devuelve PoE hacia una LiteBeam.
+El ERX tiene cinco puertos Ethernet. `eth0` recibe alimentación por PoE (alimentación a través de Ethernet) y es el puerto por el que se
+configura el router; `eth4` es el puerto WAN y el que envía PoE hacia una LiteBeam.
- Puertos del ERX, de izquierda a derecha
+ alt="Panel frontal del EdgeRouter X, con los cinco puertos Ethernet rotulados de izquierda a derecha: eth0/PoE IN, eth 1, eth 2, eth 3 y eth4/PoE OUT.">
+ Distribución de los puertos del ERX, de izquierda a derecha
+
+
+1. Conecte el ERX a su cable de alimentación y enchufe el cable de alimentación en un tomacorriente.
+2. Conecte el puerto `eth0` del ERX a su computadora con un cable Ethernet; use el adaptador Ethernet USB si su computadora no tiene puerto Ethernet.
+
+
+
+
+
+
+
+ Conecte 'eth0' al puerto Ethernet de su computadora o al adaptador Ethernet USB
-1. Conecte el ERX a su cable de alimentación y conecte el cable de alimentación a una toma de corriente.
-2. Conecte el puerto `eth0` del ERX al ordenador con un cable Ethernet, utilizando el adaptador Ethernet USB si no dispone de un puerto Ethernet.
+### 2) Configure los ajustes de red
+Siga estas instrucciones: [Configurar una IP estática en su computadora](configure-computer.md#configurar-una-direccion-ip-estatica)
-
-
+### 3a) Configure el ER-X con el asistente
+1. En su navegador, vaya al portal en [https://192.168.1.1](https://192.168.1.1).
+2. Inicie sesión en el portal con el nombre de usuario `ubnt` y la contraseña `ubnt`.
+
+
+ Pantalla de inicio de sesión del ERX
+
-### Configurar ERX
+3. Cuando aparezca el mensaje `Use wizard?` (¿Usar el asistente?), presione 'yes' (sí).
+
+
+
+
-1. Descargue el [ERX config file](../../assets/configs/erx-config.tar.gz)
-2. Navegue al portal en [https://192.168.1.1](https://192.168.1.1) en su navegador.
-3. Regístrese sesión en el portal con nombre de usuario `ubnt`, contraseña `ubnt`.
- 
-4. En el `Use wizard?` , presione no.
- 
+4. Cambie el `Port` (puerto) de `eth0` a `eth4`. Así el puerto funcionará como WAN para la antena LiteBeam.
+5. En `User Setup` (configuración de usuario), cree un usuario nuevo y establezca el nombre de usuario y la contraseña de PCW.
+6. Presione `Apply` (aplicar) y siga las instrucciones para reiniciar el dispositivo.
+7. Vuelva al portal e inicie sesión con el nombre de usuario y la contraseña de PCW (comuníquese con los responsables del proyecto para obtener estos datos).
+8. En el `Dashboard` (panel), haga clic en `Actions` (acciones) de `eth4` para activar PoE.
+9. Por último, haga clic en la pestaña `System` (sistema), en la parte inferior izquierda de la consola.
+10. Escriba el nombre de host (*host name*) del dispositivo.
+11. Configure la dirección DNS como 1.1.1.1.
+
+Para comprobar que un dispositivo está bien configurado, revise los ajustes de las pestañas `Dashboard` y `System`. Para verificar que la WAN está asignada a `eth4`, vaya a la sección `Firewall/Nat`. En la pestaña NAT, compruebe que `Masquerade` esté asignado a `eth4` para el enmascaramiento (*masquerade*) de la WAN.
+
+### 3b) Configure el ER-X con un archivo de configuración
+1. Descargue el [archivo de configuración del ERX](../../assets/configs/erx-config.tar.gz)
+2. En su navegador, vaya al portal en [https://192.168.1.1](https://192.168.1.1).
+3. Inicie sesión en el portal con el nombre de usuario `ubnt` y la contraseña `ubnt`, como se indicó arriba.
+4. Cuando aparezca el mensaje `Use wizard?`, presione 'no'.
5. Presione la pestaña `System` en la parte inferior de la página.
-6. En la sección `Restore Config` , presione `Upload a file` y seleccione el archivo de configuración de ERX que descargó.
- 
-7. El ERX se reiniciará utilizando la nueva configuración.
-8. ¡Eso es todo! Si necesita realizar más configuración, puede volver a iniciar sesión en el portal utilizando el nombre de usuario `pcwadmin`, y una contraseña que puede obtener de los mantenedores del proyecto.
+6. En la sección `Restore Config` (restaurar configuración), presione `Upload a file` (subir un archivo) y seleccione el archivo de configuración del ERX que descargó.
+
+
+ En 'Restore Config', haga clic en 'Upload a file' y suba la configuración del ERX que descargó antes.
+
+
+7. El ERX se reiniciará con la nueva configuración.
+8. Para hacer más ajustes, puede volver a iniciar sesión en el portal con el nombre de usuario y la contraseña de PCW.
+9. Asegúrese de seguir las instrucciones (pasos 10 y 11 de la sección anterior) para actualizar el nombre de host y la dirección DNS en la pestaña `System`.
+
+## Configuración en cascada (downstream)
+Este método permite que el ERX se conecte a Internet a través del router de su casa.
+
+### 1) Conecte el ERX
+1. Consulte [Conecte el ERX](#1-conecte-el-erx) en la sección anterior.
+
+### 2) Configure los ajustes de red
+2. Siga estas instrucciones: [Configurar una IP estática en su computadora](configure-computer.md#configurar-una-direccion-ip-estatica).
+3. **DESACTIVE** el wifi o su conexión a Internet.
+!!! info ""
+ Así se asegura de que, en el siguiente paso, su solicitud llegue al ERX y no al router de su casa.
+
+### 3) Configure el ERX
+1. En su navegador, vaya al portal en [https://192.168.1.1](https://192.168.1.1).
+2. Inicie sesión en el portal con el nombre de usuario `ubnt` y la contraseña `ubnt`.
+
+
+ Pantalla de inicio de sesión del ERX
+
+
+3. Cuando aparezca el mensaje `Use wizard?` (¿Usar el asistente?), presione 'yes' (sí).
+
+
+
+
+
+4. Cambie el `Port` (puerto) de `eth0` a `eth4`.
+
+5. Haga clic en 'LAN Ports' (puertos LAN) y asígnele al ERX una dirección IP **diferente** a la del router de su casa (que no sea `192.168.1.1`), en una subred diferente. Por ejemplo, configure el ERX en `192.168.5.1`.
+
+6. En `User Setup` (configuración de usuario), cree un usuario nuevo y establezca el nombre de usuario y la contraseña de PCW.
+
+7. Reinicie su router y reinicie el ERX.
+
+8. Vuelva al portal e inicie sesión con el nombre de usuario y la contraseña de PCW (comuníquese con los responsables del proyecto para obtener estos datos).
+
+9. Por último, haga clic en la pestaña `System` (sistema), en la parte inferior izquierda de la consola.
+
+10. Escriba el nombre de host (*host name*) del dispositivo.
+
+11. Configure la dirección DNS como 1.1.1.1.
+
+12. Restablezca la configuración de red de su computadora: elimine la IP estática que estableció en el [paso 2](#2-configure-los-ajustes-de-red_1) y vuelva a poner la conexión en modo dinámico (Dynamic).
+
+13. Vuelva a conectarse al ERX e inicie sesión con el nombre de usuario y la contraseña de PCW.
+
+14. Conecte el puerto `eth4` del ERX a un puerto LAN de su router. Ahora debería poder acceder a Internet a través del ERX.
+
+15. Adopte el ERX copiando la clave de UISP (*UISP key*).
+
+16. Si es necesario, actualice el firmware del ERX.
+
+## Notas de instalación
+Cuando instale el ER-X en una casa con una LiteBeam en la azotea y un AP de malla, recuerde que la configuración típica es:
+
+1. El puerto `eth0` sirve de paso (*passthrough*) para el PoE que llega desde un adaptador enchufado en un tomacorriente.
+2. El puerto `eth1` se usa para el puerto LAN del adaptador que alimenta el primer AP de malla de PCW. Los puertos `eth2` y `eth3` pueden usarse para conexiones por cable a otros APs de malla; cada uno de ellos debe alimentarse con su propio adaptador PoE.
+3. El puerto `eth4` sirve como puerto WAN, con PoE de paso para comunicarse con la LiteBeam de la azotea y alimentarla.
diff --git a/docs/es/device-configuration/troubleshoot-connection.md b/docs/es/device-configuration/troubleshoot-connection.md
new file mode 100644
index 0000000..33023ca
--- /dev/null
+++ b/docs/es/device-configuration/troubleshoot-connection.md
@@ -0,0 +1 @@
+# Solución de problemas de su conexión
diff --git a/docs/es/device-configuration/troubleshoot-devices.md b/docs/es/device-configuration/troubleshoot-devices.md
new file mode 100644
index 0000000..abb4a8a
--- /dev/null
+++ b/docs/es/device-configuration/troubleshoot-devices.md
@@ -0,0 +1,63 @@
+---
+title: Solución de problemas de dispositivos Unifi
+---
+
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../device-configuration/troubleshoot-devices/) es la referencia.
+
+No todos los dispositivos funcionarán perfectamente. Además, los dispositivos instalados al aire libre estarán expuestos a los elementos, principalmente al calor y la humedad, y se desgastarán naturalmente con el tiempo. Dicho esto, los puntos de acceso para exteriores a menudo han durado 5 años o más. En Filadelfia, rara vez tenemos un clima tan severo que dañe nuestros radios.
+
+## Indicadores LED de estado de los AP Unifi
+Cada AP Unifi tiene un LED que indica su estado actual.
+
+* **LED apagado** - El AP está fuera de línea.
+* **Blanco intermitente** - El AP está recibiendo alimentación y se está iniciando
+* **Blanco fijo** - El AP terminó su configuración y está listo para ser adoptado.
+ * Consulte [Configurar AP de malla Unifi](configure-ap-mesh.md) para ver las instrucciones de adopción.
+* **Azul fijo** - El AP está adoptado y funciona con normalidad; en nuestro caso, transmitiendo la red de Philly Community Wireless.
+* **Blanco/azul intermitente** - Se está actualizando el firmware del AP. **No desconecte el AP**.
+* **Azul intermitente** - El AP perdió la conectividad y está buscando un AP principal (*parent AP*) o un enlace ascendente (uplink).
+* **Azul/apagado intermitente rápido** - Se activó la función 'Locate' (localizar) desde el controlador Unifi (Unifi Controller).
+
+Consulte [esta página](https://help.ui.com/hc/en-us/articles/204910134-Understanding-Device-LED-Status-Indicators) (en inglés) para obtener más información sobre los indicadores LED de estado.
+
+## Solución de problemas de puntos de acceso
+### El punto de acceso no enciende; el dispositivo se reinicia pero no permanece en línea
+**Observaciones**: No hay luces; el dispositivo está fuera de línea o no aparece en el controlador.
+
+**Posibles causas y soluciones**:
+* **Fuente de alimentación inadecuada** - Revise el inyector PoE (alimentación a través de Ethernet) conectado al dispositivo y asegúrese de que la luz esté encendida y de que el voltaje sea el correcto.
+* **Conexión de alimentación o cable Ethernet defectuoso (si usa PoE)** - Pruebe si un cable Ethernet diferente suministra alimentación, para comprobar que el inyector PoE funciona correctamente. Vuelva a probar el cable defectuoso.
+
+### No se puede conectar por SSH al AP para adoptarlo
+* **Observaciones** - Las luces están encendidas y el dispositivo parece estar en línea, pero no se puede acceder a él por SSH.
+
+**Posibles causas y soluciones**
+* **Se le asignó una dirección IP distinta a la predeterminada** - La configuración de fábrica de la mayoría de los dispositivos Unifi establece su IP en `192.168.1.20` antes de la adopción; sin embargo, si esa dirección ya está en uso, es posible que se le asigne otra dirección IP al dispositivo. Pruebe con `arp -a` para encontrar el AP.
+* **Asegúrese de que su dirección IP estática esté asignada correctamente** - Revise las instrucciones en [Configurar una IP estática](configure-computer.md#configurar-una-direccion-ip-estatica) y asegúrese de estar usando la subred `192.168.1.x`.
+
+### Se envió la solicitud de adopción, pero el dispositivo no aparece en el controlador
+* **Observaciones** - El dispositivo parece estar en línea y se envió la solicitud de adopción mediante `sudo set-inform`, pero la solicitud no aparece en el controlador.
+
+**Posibles causas y soluciones**
+* **Asegúrese de que el dispositivo esté conectado a Internet** - Revise las instrucciones en [Compartir una conexión WiFi por Ethernet](configure-computer.md#compartir-una-conexion-wifi-por-ethernet) y asegúrese de que el AP tenga acceso a Internet
+* **Recargue el controlador** - A veces puede haber una demora entre el envío de la solicitud y su aparición en el controlador.
+
+### El dispositivo aparece como 'isolated' (aislado)
+* **Observaciones** - El dispositivo está marcado como 'isolated' en el controlador Unifi
+
+**Posibles causas y soluciones**
+* **El dispositivo pierde la conectividad aguas arriba (*upstream*)** - Un AP pasa a estar 'isolated' si ya no puede conectarse con el controlador Unifi. Asegúrese de que no se hayan hecho cambios en la configuración de la red que impidan que el AP se comunique con el controlador. Primero, reinicie el AP desconectándolo y volviéndolo a conectar (desconéctelo del inyector PoE, o conéctese de forma remota por `ssh` y ejecute `reboot`). Si el AP está conectado en malla, conectarlo por cable sin reiniciarlo también puede hacer que vuelva a la red. Si esto no funciona, elimine el AP y vuelva a adoptarlo. Si el problema persiste, reinicie el ERX o borre las concesiones (*leases*) de DHCP.
+
+## Solución de problemas de los ERX
+### El ERX no enciende
+**Observaciones**: No hay luces; el dispositivo está fuera de línea o no aparece en UISP.
+
+**Posibles causas y soluciones**:
+* **Conexión de alimentación o cable Ethernet defectuoso (si usa PoE)** - Pruebe el ERX con otra fuente de alimentación de 9 V y compruebe si el ERX se conecta. Pruebe cambiar a una fuente de alimentación de 9 V diferente. Si usa PoE, asegúrese de que el voltaje sea el correcto.
+
+## Comandos de terminal útiles para redes
+* `ipconfig` (Windows)/`ifconfig` (Unix) - muestra las interfaces de red e información relacionada: dirección IP, máscara de subred y puerta de enlace predeterminada.
+* `arp -a` (Windows/Unix)- Muestra la tabla del protocolo de resolución de direcciones (ARP, por sus siglas en inglés): la correspondencia entre direcciones IP y direcciones MAC.
+ * `ip neigh show` - Comando equivalente.
diff --git a/docs/es/device-configuration/unpoller.md b/docs/es/device-configuration/unpoller.md
new file mode 100644
index 0000000..3b748e5
--- /dev/null
+++ b/docs/es/device-configuration/unpoller.md
@@ -0,0 +1 @@
+# Unpoller
diff --git a/docs/es/device-configuration/useful-software.md b/docs/es/device-configuration/useful-software.md
new file mode 100644
index 0000000..b0c887b
--- /dev/null
+++ b/docs/es/device-configuration/useful-software.md
@@ -0,0 +1 @@
+# Software útil
diff --git a/docs/es/device-configuration/wireless-settings.md b/docs/es/device-configuration/wireless-settings.md
new file mode 100644
index 0000000..ec2e43d
--- /dev/null
+++ b/docs/es/device-configuration/wireless-settings.md
@@ -0,0 +1 @@
+# Configuración inalámbrica
diff --git a/docs/es/faqs.md b/docs/es/faqs.md
new file mode 100644
index 0000000..60cd6d6
--- /dev/null
+++ b/docs/es/faqs.md
@@ -0,0 +1 @@
+# Preguntas frecuentes
diff --git a/docs/es/for-network-users/configure-IoT.md b/docs/es/for-network-users/configure-IoT.md
index 7febd72..e929bfa 100644
--- a/docs/es/for-network-users/configure-IoT.md
+++ b/docs/es/for-network-users/configure-IoT.md
@@ -1,19 +1,23 @@
---
title: Configurar dispositivos IoT
---
-# Configurar dispositivos IoT
-## How to use your IoT Streaming (Chromecast, Roku, Firestick, etc) devices on the PCW public network
-The public 'Philly Community Wireless' network is not set up for Internet of Things (IoT) devices like Chromecast, Roku and Firestick to work consistently.
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../for-network-users/configure-IoT/) es la referencia.
+
+# Configurar dispositivos IoT
-If you are having trouble with them on our network, we have a hidden network called 'PCW_HIDDEN' which is set up so that those devices work best.
+## Cómo usar sus dispositivos de streaming IoT (Chromecast, Roku, Firestick, etc.) en la red pública de PCW
+La red pública 'Philly Community Wireless' no está configurada para que los dispositivos del Internet de las cosas (IoT), como Chromecast, Roku y Firestick, funcionen de manera constante.
-'Hidden' means that when you are selecting which WiFi network to connect to, you will not see its name listed. You will have to manually type in the name of the network “PCW_HIDDEN” into your device’s WiFi text box (this will depend on your device). There is no password for this network.
+Si tiene problemas con ellos en nuestra red, tenemos una red oculta llamada 'PCW_HIDDEN' que está configurada para que esos dispositivos funcionen mejor.
-## Tutorials to Change the WiFi Network for Common IoT Devices
-You might have the same device as one of these tutorials but a different version, which may change what you need to do to change your WiFi Network. If your device isn’t listed here search for “How to change WiFi network on [DEVICE NAME]”, hopefully there will be a useful tutorial.
+'Oculta' significa que, cuando elija la red wifi a la que se va a conectar, no verá su nombre en la lista. Tendrá que escribir manualmente el nombre de la red, “PCW_HIDDEN”, en el campo de texto de wifi de su dispositivo (esto depende de su dispositivo). Esta red no tiene contraseña.
-* [Chromecast](https://support.google.com/chromecast/answer/7331010?hl=en)
-* [Firestick](https://www.spectrum.net/support/internet/amazon-fire-tv-stick-wifi-connection)
-* [Roku](https://support.roku.com/en-ca/article/208754458)
+## Tutoriales para cambiar la red wifi en dispositivos IoT comunes
+Es posible que tenga el mismo dispositivo que aparece en uno de estos tutoriales, pero en otra versión, y eso puede cambiar los pasos que debe seguir para cambiar su red wifi. Si su dispositivo no aparece aquí, busque “cómo cambiar la red wifi en [NOMBRE DEL DISPOSITIVO]” (o, en inglés, “How to change WiFi network on [DEVICE NAME]”); con suerte encontrará un tutorial útil.
+* [Chromecast](https://support.google.com/chromecast/answer/7331010?hl=en) (en inglés)
+* [Firestick](https://www.spectrum.net/support/internet/amazon-fire-tv-stick-wifi-connection) (en inglés)
+* [Roku](https://support.roku.com/en-ca/article/208754458) (en inglés)
diff --git a/docs/es/for-network-users/connect-to-the-network.md b/docs/es/for-network-users/connect-to-the-network.md
index 77d6eaa..97caf56 100644
--- a/docs/es/for-network-users/connect-to-the-network.md
+++ b/docs/es/for-network-users/connect-to-the-network.md
@@ -1,8 +1,27 @@
-# Connecting to the Network
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../for-network-users/connect-to-the-network/) es la referencia.
-You can connect to PCW’s free Wi-Fi the same as any other Wi-Fi network.
+# Conectarse a la red
-* Go to your device’s Wi-Fi settings
-* Browse the list of available Wi-Fi networks for “PhillyCommunityWireless”
- * If you have a private connection, you can also look for “PCWPrivate”
-* Select “PhillyCommunityWireless”/”PCWPrivate” and click “connect”.
+El wifi gratuito de PCW está disponible en las zonas que aparecen en nuestro [mapa de la red](https://phillycommunitywireless.org/networkmap). Si quiere preguntar cómo obtener cobertura para su edificio, consulte la página [Get connected](https://phillycommunitywireless.org/getconnected) (Conéctese, en inglés) de nuestro sitio principal.
+
+## Cómo conectarse
+
+Puede conectarse al wifi gratuito de PCW igual que a cualquier otra red wifi.
+
+* Abra la configuración de wifi de su dispositivo.
+* Busque “Philly Community Wireless” en la lista de redes wifi disponibles.
+* Seleccione “Philly Community Wireless” y haga clic en “Conectar” (o “Connect”, si su dispositivo está en inglés).
+
+Es posible que los dispositivos de streaming y los televisores inteligentes (Chromecast, Roku, Firestick, etc.) no funcionen de manera constante en la red pública. Consulte [Configurar dispositivos IoT](configure-IoT.md) para conocer una red preparada para ellos.
+
+## Si no puede conectarse
+
+* **No ve “Philly Community Wireless” en la lista.** Consulte el [mapa de la red](https://phillycommunitywireless.org/networkmap) para asegurarse de que está en una zona de cobertura. Las señales de wifi se debilitan al atravesar paredes, así que pruebe acercarse a una ventana o al lugar donde está instalado el punto de acceso.
+* **Está conectado, pero las páginas no cargan.** Apague el wifi de su dispositivo y vuelva a encenderlo. Si eso no funciona, elija “Olvidar” la red (“Forget”) en la configuración de wifi y luego vuelva a conectarse a ella.
+* **Sigue sin funcionar.** Escríbanos a info@phillycommunitywireless.org. Díganos dónde está (una dirección o la intersección más cercana), qué dispositivo está usando y qué pasa cuando intenta conectarse.
+
+## Cómo usar el wifi público de forma segura
+
+Como cualquier red wifi pública, la red de PCW se comparte con otras personas que están cerca. Cuando escriba contraseñas o información personal, verifique que la dirección del sitio web empiece con `https://` (la mayoría de los navegadores muestran un ícono de candado junto a ella).
diff --git a/docs/es/glossary.md b/docs/es/glossary.md
new file mode 100644
index 0000000..ed114e5
--- /dev/null
+++ b/docs/es/glossary.md
@@ -0,0 +1,66 @@
+---
+title: Glosario
+---
+
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../glossary/) es la referencia.
+
+# Glosario
+
+Términos que aparecen en esta documentación y durante las instalaciones. Las siglas también se definen dentro de cada página:
+pase el cursor sobre cualquier término subrayado con puntos para ver su definición sin salir de la página.
+
+## Conceptos de red
+
+**Mesh — malla (red de malla)**
+: Un tipo de red de área local (LAN) formada por varios nodos que trabajan juntos para transmitir una señal wifi en un área amplia. "Meshing" (interconexión en malla) se refiere a la capacidad de enlazar varios nodos dentro de la misma red, lo que amplía el área de servicio.
+
+**WiFi access point (AP) — punto de acceso wifi**
+: Un dispositivo de red inalámbrica que funciona como portal para que otros dispositivos se conecten a una red de área local. Los puntos de acceso se usan para ampliar la cobertura inalámbrica de una red existente y para aumentar el número de usuarios que pueden conectarse a ella.
+
+**Hub — hub (nodo central)**
+: Para PCW, un hub es una instalación en la que usamos un radio para "captar" la conectividad inalámbrica. Cuando hacemos instalaciones de hub, estas incluyen a PhillyWisper.
+
+**Node — nodo**
+: Una instalación de malla que no requiere radio ni router; funciona como una zona de retransmisión que extiende la conectividad wifi desde un hub.
+
+**Line-of-sight (LoS) — línea de visión**
+: Nuestro wifi depende de que haya "línea de visión" entre las antenas sectoriales de PhillyWisper ubicadas en puntos altos y una azotea (u otro lugar) donde podamos instalar un radio para "captar" la conectividad inalámbrica. [Más información sobre la propagación con línea de visión](https://www.techtarget.com/whatis/definition/line-of-sight-LOS) (en inglés)
+
+**Point-to-point (PtP) — punto a punto**
+: Una red formada por solo dos nodos que se comunican directamente entre sí.
+
+**Point-to-multi-point (PtMP) — punto a multipunto**
+: Una red en la que un único punto de acceso central se conecta con varias estaciones remotas.
+
+**Wireless internet service provider (WISP) — proveedor de servicios de Internet inalámbrico**
+: Un proveedor de servicios de Internet que ofrece el último tramo de la conexión (la "última milla") por radio, en lugar de por cable o fibra óptica. [PhillyWisper](https://phillywisper.net/), el socio de red de PCW, es un WISP.
+
+## Equipos
+
+**Unifi (de Ubiquiti)**
+: La marca de equipos wifi que usa PCW; una familia de puntos de acceso inalámbricos, conmutadores (switches), routers, controladores, teléfonos VoIP y productos de control de acceso. [Línea de productos Unifi](https://techspecs.ui.com/unifi) (en inglés)
+
+**EdgeRouter-X (ERX)**
+: El router que PCW usa como conmutador (switch); un conmutador transfiere datos entre dispositivos. [Página del producto EdgeRouter X](https://store.ui.com/us/en/pro/category/wired-edge-max-routing/products/er-x) (en inglés)
+
+**Power over Ethernet (PoE) — alimentación a través de Ethernet**
+: Transmisión de energía eléctrica junto con los datos por el cableado Ethernet, de modo que un dispositivo exterior pueda recibir electricidad desde un tomacorriente interior. [Página del producto: inyector PoE](https://store.ui.com/us/en/pro/products/poe-24) (en inglés)
+
+**Bunny ears — orejas de conejo**
+: Apodo que PCW le da al Ubiquiti UAP-AC-Mesh, por sus dos antenas verticales. [Página del producto UAP-AC-Mesh](https://store.ui.com/us/en/collections/unifi-wifi-outdoor-long-range/products/uap-ac-mesh) (en inglés)
+
+**Panel antenna — antena de panel**
+: Apodo que PCW le da a la Ubiquiti UMA-D, una antena direccional plana que se acopla a un UAP-AC-M en lugar de sus antenas para dirigir la cobertura hacia una sola dirección. [Página del producto UMA-D](https://store.ui.com/collections/operator-airmax-and-ltu-antennas/products/directional-dual-band-antenna-for-uap-ac-m) (en inglés)
+
+**UFO AP — AP "OVNI"**
+: Apodo que PCW le da al Ubiquiti U6 Pro, un punto de acceso redondo para interiores que se instala en el techo o en la pared. [Página del producto U6 Pro](https://store.ui.com/us/en/category/wifi-flagship/products/u6-pro) (en inglés)
+
+## Montaje y electricidad
+
+**Non-penetrating roof mount (NPRM, "Non-Pen") — soporte de techo no penetrante**
+: Un soporte con lastre que usamos para radios y dispositivos wifi más grandes, de modo que no tengamos que perforar ningún techo; se sujeta con tapetes de goma y bloques de concreto.
+
+**Ground-fault circuit interrupter (GFCI) — interruptor de circuito por falla a tierra**
+: Un tomacorriente que corta la electricidad cuando detecta una falla. La alimentación eléctrica exterior en una azotea debe estar conectada a un tomacorriente GFCI con tapa.
diff --git a/docs/es/index.md b/docs/es/index.md
index 0d3ba64..ce1b6c6 100644
--- a/docs/es/index.md
+++ b/docs/es/index.md
@@ -6,26 +6,26 @@ title: Inicio
**Philly Community Wireless** (PCW) es un proyecto para desarrollar redes de malla de propiedad comunitaria en North Philly. Somos un grupo de trabajo de organizadores, tecnólogos, académicos, maestros de escuelas públicas y personal del Ayuntamiento de Filadelfia. Durante una época de distanciamiento social y enseñanza en línea, aproximadamente la mitad de los estudiantes de las escuelas públicas de la ciudad carecen de conexión wifi en casa. En ciertos vecindarios, aún más residentes carecen de conexión a Internet. Buscamos abordar la brecha digital de **la ciudad con tecnologías de red de malla operadas y propiedad de la comunidad.**
-Las redes de malla permiten compartir una única conexión a Internet entre un grupo más amplio de usuarios con muy poco coste o infraestructura necesaria. Con la ayuda de **PhillyWisper**, un proveedor de servicios de Internet inalámbrico, pro-neutral, estamos trabajando para instalar dos sitios piloto en **Kensington y Fairhill**. A partir de ahí, planearemos talleres de diseño participativo y capacitación técnica para la comunidad que los capacitará para mantener y hacer crecer esta conexión de red gratuita.
+Las redes de malla permiten compartir una única conexión a Internet entre un grupo más amplio de usuarios con muy poco costo o infraestructura necesaria. Con la ayuda de **PhillyWisper**, un proveedor de servicios de Internet inalámbrico que defiende la neutralidad de la red, estamos trabajando para instalar dos sitios piloto en **Kensington y Fairhill**. A partir de ahí, planearemos talleres de diseño participativo y capacitación técnica para la comunidad que los capacitará para mantener y hacer crecer esta conexión de red gratuita.
## Los documentos de PCW
Esta página de documentos proporciona información técnica en desarrollo y guías para replicar la configuración y distribución del proyecto de routers y antenas para construir una red de malla.
-Si está buscando una **descripción no técnica del proyecto** o está interesado en suscribirse a la cobertura de PCW, visite nuestra [homepage](https://phillycommunitywireless.org).
+Si está buscando una **descripción no técnica del proyecto** o está interesado en suscribirse a la cobertura de PCW, visite nuestra [página principal](https://phillycommunitywireless.org).
## Por dónde empezar
-### Para anfitriones de antenas
+### Para anfitriones de antena
-*Aloja una antena en su azotea, o está considerándolo.*
+*Usted aloja una antena en su azotea o está pensando en hacerlo.*
-- [Descripción general](installations/installations.md) — en qué consiste una instalación en la azotea
+- [Descripción general de la instalación](installations/installations.md) — en qué consiste una instalación en la azotea, de principio a fin
### Para voluntarios
-*Ayuda a construir y mantener la red.*
+*Usted ayuda a construir y mantener la red.*
**Instalaciones**
@@ -36,30 +36,30 @@ Si está buscando una **descripción no técnica del proyecto** o está interesa
**Redes y configuración de dispositivos**
- [Configurar una IP estática](device-configuration/configure-computer.md)
-- [Configurar EdgeRouter X](device-configuration/configure-edgerouter-x.md)
+- [Configurar routers con EdgeOS](device-configuration/configure-edgerouter-x.md)
- [Configurar APs Unifi](device-configuration/configure-ap-mesh.md)
-- [Solución de problemas](device-configuration/troubleshoot-devices.md)
+- [Solución de problemas de dispositivos Unifi](device-configuration/troubleshoot-devices.md)
**Solar**
-- [Nodos solares](installations/solar.md)
+- [Nodos solares de malla](installations/solar.md)
- [Recursos de tecnología verde](installations/green-technology.md)
### Para usuarios de la red
-*Está conectado a una red de PCW, o quiere estarlo.*
+*Usted está conectado a una red de PCW o quiere estarlo.*
- [Conectarse a la red](for-network-users/connect-to-the-network.md)
- [Configurar dispositivos IoT](for-network-users/configure-IoT.md)
-- [Conéctate](https://phillycommunitywireless.org/getconnected) — áreas de cobertura e inscripción, en el sitio principal
+- [Conéctese](https://phillycommunitywireless.org/getconnected) — áreas de cobertura e inscripción, en el sitio principal
### Recursos
- [Glosario](glossary.md)
-- [Más recursos](resources.md) — recursos secundarios sobre el acceso de banda ancha y la inequidad digital en ciudades como Philadelphia
+- [Lecturas adicionales](resources.md) — recursos secundarios sobre el acceso de banda ancha y la inequidad digital en ciudades como Philadelphia
-## Participa
+## Participe
-- [**Conéctate al wifi gratuito, o aloja una antena**](https://tally.so/r/mR8VM9)
-- [**Ser voluntario con PCW**](https://tally.so/r/w2ODaj)
+- [**Conéctese al wifi gratuito o aloje una antena**](https://tally.so/r/mR8VM9)
+- [**Sea voluntario de PCW**](https://tally.so/r/w2ODaj)
- [**Suscríbase a nuestro boletín**](https://phillycommunitywireless.us5.list-manage.com/subscribe?u=7a97e4278a5833f5505a85940&id=6af414f631)
diff --git a/docs/es/installations/ap-placement.md b/docs/es/installations/ap-placement.md
new file mode 100644
index 0000000..102ea94
--- /dev/null
+++ b/docs/es/installations/ap-placement.md
@@ -0,0 +1,41 @@
+---
+title: Ubicación de los puntos de acceso
+---
+
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../installations/ap-placement/) es la referencia.
+
+# Ubicación de los puntos de acceso
+
+El lugar donde se coloca un punto de acceso importa tanto como el modelo de punto de acceso que se utiliza. Esta página explica cómo PCW
+decide dónde colocar los APs: la diferencia entre un hub (nodo central) y un nodo, y qué tener en cuenta cuando un
+nodo se conecta en malla de forma inalámbrica en lugar de por cable.
+
+## Hubs y nodos
+
+Los nodos de malla son instalaciones en las que no usamos una antena LiteBeam, sino que colocamos un punto de acceso
+inalámbrico que se conecta en malla a un punto de acceso cercano, el cual está conectado por cable a un router y a una LiteBeam en un hub local.
+
+Si un sitio puede ser un hub se decide durante la [evaluación del edificio](buildingassessment.md):
+un hub necesita línea de visión con un sitio alto de PhillyWisper. Un nodo no la necesita, pero sí requiere un buen
+enlace inalámbrico de regreso a un hub, que es el tema del resto de esta página.
+
+## Consideraciones al instalar un nodo de malla
+
+La guía de Ubiquiti [Considerations for Optimal Wireless Mesh Networks](https://help.ui.com/hc/en-us/articles/115002262328-Considerations-for-Optimal-Wireless-Mesh-Networks)
+(consideraciones para redes de malla inalámbricas óptimas, en inglés) es nuestra referencia de trabajo. Los puntos que surgen con más frecuencia en las instalaciones de PCW son:
+
+* **Las redes de malla deben ser complementarias**: aunque una red de malla puede funcionar de manera comparable a una red cableada, la calidad y la velocidad de la conexión pueden verse muy afectadas por el ruido de radiofrecuencia (RF) y por obstáculos entre los APs, como paredes, árboles u otras estructuras.
+* **Se deben minimizar los "saltos" de la malla**: un AP de malla debe tener un solo "padre". Cada "salto" de la malla, es decir, cada conexión en malla entre APs, provoca una disminución significativa del rendimiento. Lo ideal es un máximo de dos "saltos"; por ejemplo, un AP de malla se conecta a otro AP de malla, que a su vez se conecta a un AP cableado.
+* **Limite las conexiones simultáneas a un mismo "padre"**: del mismo modo, conectar demasiados APs en malla al mismo "padre" genera más ruido de RF y más exigencias de rendimiento sobre ese AP, lo que reduce el rendimiento y la estabilidad.
+* **Asegure una señal fuerte entre los APs de malla**: lo ideal es que un AP de malla tenga línea de visión (LoS) despejada con su AP padre. Se recomienda una intensidad de señal de -60 dBm para un rendimiento óptimo. Procure que haya los menos obstáculos posibles entre el AP de malla y el padre, como paredes, árboles, muebles, etc.
+
+## Ubicación en exteriores
+
+Los APs de exterior deben montarse donde tengan visibilidad de radio con los APs de malla de las instalaciones domésticas que estén
+dentro de su alcance, y a una altura suficiente para sobrepasar lo que haya a su alrededor. En los [nodos solares](solar.md), eso normalmente
+significa que el AP va en la parte superior del mástil, con el panel y la caja montados debajo.
+
+Para saber cómo configurar un AP una vez colocado, consulte la guía
+[Configurar APs Unifi](../device-configuration/configure-ap-mesh.md).
diff --git a/docs/es/installations/buildingassessment.md b/docs/es/installations/buildingassessment.md
new file mode 100644
index 0000000..d8a2373
--- /dev/null
+++ b/docs/es/installations/buildingassessment.md
@@ -0,0 +1,51 @@
+---
+title: Evaluación del edificio
+---
+
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../installations/buildingassessment/) es la referencia.
+
+PCW instala wifi con regularidad en una gran variedad de edificios, como casas en hilera, edificios multifamiliares (MDUs), centros comunitarios y espacios públicos como parques y jardines.
+
+Para evaluar si un edificio es adecuado para una instalación, debemos hacernos las siguientes preguntas:
+
+* **¿Tiene el edificio línea de visión (LoS) hacia un sitio alto de PhillyWisper, o está muy cerca de un nodo de malla de PCW existente?**
+ * Sin LoS directa hacia un sitio alto o un nodo existente, el rendimiento de la radio de enlace ascendente (uplink) se reducirá considerablemente (si es que logra conectarse).
+ * Google Earth puede ser una herramienta útil para determinar si existe una posible LoS, pero en muchos casos puede ser necesaria una visita al lugar.
+ * El follaje de los árboles puede causar interferencias importantes: ¡los lugares que funcionan en invierno pueden quedar bloqueados por el follaje en verano!
+ * Además, las construcciones nuevas aparecen de repente. Es importante verificar en persona las condiciones del lugar, ya que Google Maps y herramientas similares pueden no tener actualizado el entorno.
+
+* **¿El acceso a la azotea o al último piso del edificio es fácil, seguro y sencillo?**
+ * ¿Se necesitan escaleras de mano? ¿Hay escaleras o una escotilla de acceso a la azotea?
+ * Lo ideal es instalar las LiteBeam en la azotea, ya sea en una estructura existente del techo, con un soporte tipo J (J-arm) en la pared o con un soporte de techo no penetrante.
+ * ¿Tenemos permiso para instalar equipos en el edificio o en las estructuras de la azotea?
+ * PCW solo instala en techos planos, salvo raras excepciones.
+
+* **¿Hay acceso a electricidad?**
+ * Si la toma está en el exterior, ¿está protegida?
+ * ¿Será necesario usar la toma de corriente para otra cosa? ¿Tienen acceso a ella otras personas que podrían desconectar nuestro equipo?
+ * ¿Hay perforaciones existentes que podamos reutilizar para llevar la alimentación a través de Ethernet (PoE) desde el interior?
+ * PCW NO perfora techos, ya que es muy difícil impermeabilizarlos.
+
+* **¿Hay maneras fáciles de montar los puntos de acceso?**
+ * Por ejemplo: postes existentes a los que podríamos simplemente sujetar los APs con amarres plásticos (zip ties), en lugar de traer un soporte de techo no penetrante o un soporte tipo J.
+ * ¿Cuánto cable tendremos que tender?
+ * ¿Qué tipo de puntos de acceso se necesitarán? Algunos no son resistentes a la intemperie y solo pueden usarse en interiores.
+ * ¿Existe la posibilidad de que el montaje de los puntos de acceso dañe el techo o las paredes?
+ * ¿Hay infraestructura de Internet existente (instalaciones anteriores de cable coaxial o de fibra óptica) que debamos tener en cuenta? Los cables que corren en paralelo pueden interferir entre sí y reducir el rendimiento de ambas conexiones.
+
+* **Si se necesita mantenimiento, ¿podremos regresar en el futuro?**
+
+Por ejemplo, este es un lugar ideal para una instalación:
+
+
+
+ Un lugar ideal para una instalación en azotea en Kensington
+
+
+* La azotea es plana y está libre de escombros, con mucho espacio para soportes de techo no penetrantes.
+* El edificio es más alto que casi todos los demás edificios de la zona, lo que le da LoS despejada tanto hacia los sitios altos de PhillyWisper como hacia otros posibles sitios PtP/PtMP.
+* Hay electricidad en la azotea; en este caso, tomacorrientes GFCI con tapa protectora.
diff --git a/docs/es/installations/green-technology.md b/docs/es/installations/green-technology.md
new file mode 100644
index 0000000..1a8d18a
--- /dev/null
+++ b/docs/es/installations/green-technology.md
@@ -0,0 +1,37 @@
+---
+title: Recursos de tecnología verde
+---
+
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../installations/green-technology/) es la referencia.
+
+# Recursos de tecnología verde
+
+Programas, financiamiento y recursos de monitoreo relacionados con el trabajo de PCW en espacios verdes. Para saber cómo se construyen y se mantienen los nodos solares, consulte [Nodos solares de malla](solar.md).
+
+## Programas solares en Filadelfia
+
+* [Solarize Greater Philadelphia](https://solarizegreaterphl.org/) es un programa de toda la ciudad para ayudar a todos los residentes de Filadelfia a pasarse a la energía solar, administrado por la Philadelphia Energy Authority (PEA, la Autoridad de Energía de Filadelfia). La PEA preaprueba a los instaladores y los equipos, y negocia descuentos grupales y protecciones para el consumidor, para que instalar paneles solares sea lo más fácil y económico posible. Los propietarios de vivienda también pueden pasarse a la energía solar mediante un arrendamiento, sin costo inicial.
+* [Solar for All (EPA)](https://phillygreencapital.org/news/solar-for-all-pennsylvania/) ofrece financiamiento para ayudar a las comunidades de bajos ingresos a instalar sistemas solares, que podrían combinarse con infraestructura de wifi. A nivel local, lo implementa la Philadelphia Green Capital Corp (PGCC).
+* [Philadelphia Solar Rebate](https://www.phila.gov/programs/solar-rebate-program/) (reembolso solar de Filadelfia) es un incentivo único de la Ciudad que se paga después de que un proyecto solar se ha instalado y ha recibido de PECO el permiso para operar (Permission to Operate): $0.20/vatio para viviendas y $0.10/vatio para comercios, con un límite de $100,000. Lo administra la PEA en nombre de la Office of Sustainability (Oficina de Sostenibilidad).
+
+ !!! warning ""
+
+ Consulte la página del programa antes de recomendarle a alguien este reembolso. En agosto de 2026, la Ciudad lo indica como sin fondos; las solicitudes se procesarán por orden de llegada solo si se restablece el financiamiento.
+
+## Agricultura urbana
+
+* [Grounded in Philly](https://groundedinphilly.org/resources/)
+* [Pennsylvania Horticultural Society](https://phsonline.org/programs/community-gardens)
+* [Farm Philly](https://www.phila.gov/programs/farmphilly/)
+* [Neighborhood Gardens Trust](https://www.ngtrust.org/resources/)
+
+## Monitoreo ambiental
+
+Programas relacionados con el trabajo con sensores que se describe en la página de nodos solares, como alimentar un [monitor de calidad del aire PurpleAir](https://www.purpleair.com/products/classic-plus-air-quality-monitor) con un nodo solar modificado.
+
+* [DVRPC — Municipal Management of Extreme Heat](https://www.dvrpc.org/energyclimate/extremeheat/) (gestión municipal del calor extremo) presenta mapas de islas de calor, proyecciones del índice de calor y un Índice de Vulnerabilidad al Calor (Heat Vulnerability Index) por sector censal en toda el área metropolitana de Filadelfia. Es útil para identificar zonas propensas al calor junto con la recopilación de datos dirigida por la comunidad.
+* [Beat the Heat Toolkit](https://www.phila.gov/departments/office-of-sustainability/beat-the-heat-toolkit/) (guía para combatir el calor), de la Oficina de Sostenibilidad de la Ciudad, explica en diez pasos cómo un vecindario puede iniciar su propio proyecto de resiliencia ante el calor, incluidos talleres comunitarios.
+* [NOAA Urban Heat Island Mapping Campaigns](https://www.heat.gov/pages/community-science-campaigns) (campañas de mapeo de islas de calor urbanas) son programas de ciencia comunitaria para mapear los puntos de mayor calor. Las comunidades participantes reciben sensores y capacitación sin costo. Las convocatorias se anuncian cada año, así que verifique si hay una abierta.
+* [Community Progress](https://communityprogress.org/services/technical-assistance/) ofrece asistencia técnica para iniciativas comunitarias sobre propiedades abandonadas y la prevención del vertido ilegal de basura.
diff --git a/docs/es/installations/handbook/assessment-planning.md b/docs/es/installations/handbook/assessment-planning.md
new file mode 100644
index 0000000..9617848
--- /dev/null
+++ b/docs/es/installations/handbook/assessment-planning.md
@@ -0,0 +1 @@
+# Evaluación y planificación
diff --git a/docs/es/installations/handbook/etiquette.md b/docs/es/installations/handbook/etiquette.md
new file mode 100644
index 0000000..23329e2
--- /dev/null
+++ b/docs/es/installations/handbook/etiquette.md
@@ -0,0 +1 @@
+# Normas de conducta en el sitio
diff --git a/docs/es/installations/handbook/install-day-and-maintenance.md b/docs/es/installations/handbook/install-day-and-maintenance.md
new file mode 100644
index 0000000..7413d4f
--- /dev/null
+++ b/docs/es/installations/handbook/install-day-and-maintenance.md
@@ -0,0 +1 @@
+# El día de la instalación y el mantenimiento
diff --git a/docs/es/installations/handbook/overview.md b/docs/es/installations/handbook/overview.md
new file mode 100644
index 0000000..766a89a
--- /dev/null
+++ b/docs/es/installations/handbook/overview.md
@@ -0,0 +1 @@
+# Descripción general
diff --git a/docs/es/installations/handbook/phases-overview.md b/docs/es/installations/handbook/phases-overview.md
new file mode 100644
index 0000000..5de025a
--- /dev/null
+++ b/docs/es/installations/handbook/phases-overview.md
@@ -0,0 +1 @@
+# Descripción general de las fases de instalación
diff --git a/docs/es/installations/handbook/risks-rooftop-ladder-drill.md b/docs/es/installations/handbook/risks-rooftop-ladder-drill.md
new file mode 100644
index 0000000..cb6c2bb
--- /dev/null
+++ b/docs/es/installations/handbook/risks-rooftop-ladder-drill.md
@@ -0,0 +1 @@
+# Seguridad en azoteas, escaleras y con taladros
diff --git a/docs/es/installations/handbook/risks-weather-environment.md b/docs/es/installations/handbook/risks-weather-environment.md
new file mode 100644
index 0000000..829e78b
--- /dev/null
+++ b/docs/es/installations/handbook/risks-weather-environment.md
@@ -0,0 +1 @@
+# Riesgos climáticos y ambientales
diff --git a/docs/es/installations/handbook/safety-basics.md b/docs/es/installations/handbook/safety-basics.md
new file mode 100644
index 0000000..c1c6cef
--- /dev/null
+++ b/docs/es/installations/handbook/safety-basics.md
@@ -0,0 +1 @@
+# Seguridad básica
diff --git a/docs/es/installations/handbook/safety-buildings-electrical.md b/docs/es/installations/handbook/safety-buildings-electrical.md
new file mode 100644
index 0000000..21a9101
--- /dev/null
+++ b/docs/es/installations/handbook/safety-buildings-electrical.md
@@ -0,0 +1 @@
+# Seguridad en edificios y eléctrica
diff --git a/docs/es/installations/hardware.md b/docs/es/installations/hardware.md
index 078e272..733de62 100644
--- a/docs/es/installations/hardware.md
+++ b/docs/es/installations/hardware.md
@@ -1,55 +1,201 @@
---
-Title: Hardware
-
+title: Hardware
---
-# Hardware requerido
-## Kit de malla
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../installations/hardware/) es la referencia.
+
+# Hardware
+
+Los siguientes materiales se usan en las [instalaciones](installations.md). Puede encontrar más información sobre cómo configurar muchos de estos dispositivos en las guías de instalación de esta documentación.
-* [Ubiquiti Mesh Dual-Band Access Point](https://store.ui.com/products/unifi-ac-mesh-ap)
+Consulte los documentos de NYCMesh [Networking Hardware](https://wiki.nycmesh.net/books/3-hardware-firmware) (equipos de red) e [Installation Equipment](https://wiki.nycmesh.net/books/2-install-maintenance-guides/page/install-tools-and-equipment) (equipos de instalación), en inglés, para ver más detalles e información sobre el hardware y las herramientas que aparecen a continuación.
-## Instalación de antena en la azotea
+## Equipos de red
+
+### Puntos de acceso
+
+#### Instalaciones en interiores y exteriores
+
+La UMA-D se acopla a un UAP-AC-M en lugar de sus antenas, para dirigir la cobertura hacia una sola dirección
+en vez de repartirla de manera uniforme.
+
+- [Ubiquiti UAP-Flex-HD](https://store.ui.com/us/en/products/uap-flexhd)
+- [Ubiquiti U6 Mesh](https://store.ui.com/us/en/products/u6-mesh)
+- [Ubiquiti U6 Mesh Pro](https://store.ui.com/us/en/products/u6-mesh-pro)
+- [Ubiquiti U6 LR](https://store.ui.com/us/en/products/u6-lr)
+- [Ubiquiti UAP-AC-M-Pro](https://store.ui.com/us/en/products/uap-ac-mesh-pro)
+- [Ubiquiti U7 Outdoor](https://store.ui.com/us/en/products/u7-outdoor)
+- [Ubiquiti Swiss Army Knife](https://store.ui.com/us/en/products/uk-ultra)
+
+#### Instalaciones en interiores
+
+Los puntos de acceso para interiores vienen en tres formas. Cuál le conviene depende principalmente de dónde
+se puede montar en el sitio.
+
+
-
- UAP-AC-M
+
+ Redondo, de techo o pared nanoHD, U6 Lite, U6+, U6 Pro, U7 Lite, U7 Pro
-
- UMA-D Se acopla al UAP-AC-M
+
+ Placa empotrada en la pared UAP-AC-IW, U7 In-Wall
+
+
+
+ Se enchufa al tomacorriente UAP-BeaconHD
+
+
+
+- [Ubiquiti UAP-nanoHD](https://store.ui.com/us/en/products/uap-nanohd)
+- [Ubiquiti UAP-AC-Inwall](https://store.ui.com/us/en/products/uap-ac-iw)
+- [Ubiquiti U6 Extender](https://store.ui.com/us/en/products/u6-extender)
+- [Ubiquiti U6+](https://store.ui.com/us/en/products/u6-plus)
+- [Ubiquiti U6 Lite](https://store.ui.com/us/en/products/u6-lite)
+- [Ubiquiti U6 Pro - 'UFO AP' (AP "OVNI")](https://store.ui.com/us/en/category/wifi-flagship/products/u6-pro)
+- [Ubiquiti U7 Lite](https://store.ui.com/us/en/products/u7-lite)
+- [Ubiquiti U7 Pro](https://store.ui.com/us/en/products/u7-pro)
+- [Ubiquiti U7 Pro Max](https://store.ui.com/us/en/products/u7-pro-max)
+- [Ubiquiti U7 In-Wall](https://store.ui.com/us/en/products/u7-iw)
+- [Ubiquiti U7 Long Range](https://store.ui.com/us/en/products/u7-lr)
+- [Ubiquiti UAP-BeaconHD](https://store.ui.com/us/en/products/uap-beaconhd)
+
+### Conmutadores (switches)
+- [Ubiquiti USW Flex Mini](https://store.ui.com/us/en/products/usw-flex-mini)
+- [Ubiquiti USW Flex](https://store.ui.com/us/en/category/switching-utility/products/usw-flex)
+
+
+
+ Puertos del USW Flex Mini. El puerto 1 recibe la entrada PoE (alimentación a través de Ethernet) y alimenta el switch, así que es el que va de regreso hacia el router.
+
+
+### Routers
+- [Ubiquiti EdgeRouter X](https://store.ui.com/collections/operator-edgemax-routers/products/edgerouter-x)
+- [Ubiquiti EdgePoint R6](https://store.ui.com/collections/operator-edgemax-control-points/products/edgepoint-r6) - consulte el [documento de NYC Mesh](https://wiki.nycmesh.net/books/3-hardware-firmware/page/ubiquiti-edgepoint-r6) (en inglés) sobre esta alternativa al ER-X.
+
+
+
+ Puertos del ERX. Consulte Configurar EdgeRouter X para saber qué se conecta en cada uno.
+
+
+### Radios PtP y PtMP
+
+
-* [airMAX LiteBeam AC 5 GHz Bridge](https://store.ui.com/collections/wireless/products/litebeam-5ac-gen2)
-* [Ubiquiti EdgeRouter ERX](https://dl.ui.com/qsg/ER-X/ER-X_EN.html)
-* [Ubiquiti Mesh Dual-Band Access Point](https://store.ui.com/products/unifi-ac-mesh-ap)
+- [airMAX LiteBeam AC 5 GHz Bridge](https://store.ui.com/collections/wireless/products/litebeam-5ac-gen2)
+- [airMAX PowerBeam 5ac 500](https://techspecs.ui.com/uisp/wireless/pbe-5ac-500)
+- [airMAX NanoBeam M5](https://store.ui.com/us/en/products/nbe-m5-16)
+- [airMAX NanoStation M5 loco](https://store.ui.com/us/en/category/wireless-airmax-5ghz/products/locom5)
+
+### Soportes
+
+- [Soporte universal de brazo en J (Universal J-Arm Mount)](https://store.ui.com/collections/operator-airmax-and-ltu-accessories/products/universal-antenna-mount)
+- [Soporte para ventana (Window Mount)](https://store.ui.com/collections/operator-airmax-and-ltu-accessories/products/nanostation-window-mount)
+- [Soporte de techo no penetrante](https://www.data-alliance.net/roof-mounts/)
+- Caja(s) protectora(s)
+
+### Accesorios
+
+
+
+ Un inyector PoE alimenta un AP a través de su cable Ethernet, así que el AP no necesita un tomacorriente propio.
+
+
+- Cable(s) Ethernet de largo corto a mediano
+- Regleta(s) eléctrica(s) apta(s) para exteriores
+- Extensión(es) eléctrica(s) apta(s) para exteriores
+- Divisor(es) de corriente apto(s) para exteriores
+- [Extensiones eléctricas](https://www.newegg.com/black-monoprice-6-00-ft-others/p/0N6-01B8-002D6)
+- [Inyector/divisor PoE](https://www.newegg.com/p/2WG-00DK-00004)
+- [Adaptador/acoplador de Ethernet a Ethernet](https://www.newegg.com/p/0Y3-02J6-00001)
+- Conectores Ethernet (RJ45) de paso (*pass-through*)
+- [Adaptador de USB tipo C a Ethernet](https://www.ebay.com/itm/132225990432?epid=910384900&hash=item1ec9487f20:g:FhgAAOSwqiVdyN)
+
+## Herramientas
-## Antenas adicionales
+### Redes
-* [Ubiquiti Directional Dual-Band Antenna](https://store.ui.com/collections/operator-airmax-and-ltu-antennas/products/directional-dual-band-antenna-for-uap-ac-m)
+- [Crimpadora (ponchadora) para cable Ethernet](https://www.homedepot.com/p/Klein-Tools-Compact-Ratcheting-Modular-Crimper-VDV226-107/204732347?source=shoppingads&locale=en-US&srsltid=AfmBOopOP-5p-ibEZ6Xg-9GSiYkxoTyprixZLrUXPKiSeqJMjNqTxc5oPwU)
+- Pelacables para cable CAT5e
+- [Probador de cable Ethernet](https://www.lowes.com/pd/Klein-Tools-Cable-Tester-Kit-with-Scout-Pro-3-Tester-Remotes-Adapter-Battery/5014306081)
+- Hotspot móvil
+- Analizador de espectro Unifi WifiMan
-### Routers alternativos
+### Herramientas manuales y eléctricas
-* [MikroTik hEX PoE](https://www.doubleradius.com/mikrotik-hex-poe-rb960pgs)
+- Taladro(s): taladro atornillador, taladro percutor
+- Atornillador de impacto
+- Juego de brocas
+- Broca de cobalto / titanio (1/4")
+- Broca para mampostería con punta de carburo (5/32")
+- Puntas de dado hexagonal para taladro (3/8" para abrazaderas de manguera y 1/4" para tornillos de mampostería)
+- Brocas para mortero y para madera
+- Martillo
+- Tijeras
+- Tijeras para lámina (*snips*)
+- Alicates de punta
+- Destornilladores: Phillips (de cruz), plano, Torx
+- Llaves de dado
+- Cinta métrica
+- Medidor láser
+- Guía pasacables (*fish tape*) / varilla de empuje
+- Limas: triangular, plana, redonda
+- Llave ajustable (perico) de 6"
+- Bolsa adicional para cargar o subir el equipo
+- Soga
+- Cuchilla multiuso
+- Llaves Allen
+- Pelador de cables eléctricos
-## Accesorios
+### Materiales consumibles
+- Clavos para concreto
+- Tornillos para concreto (cabeza hexagonal de 3/16", CSH316134)
+- Tornillos
+- Clavos
+- Grapas de sujeción para cables
+- Abrazaderas de manguera
+- Amarracables (*zip ties*)
+- Cinta aislante
+- Tiras de velcro
+- Amarres de velcro para cables
+- Calcomanías (*stickers*) de PCW
+- Sellador impermeable de goma
+- Pegamento instantáneo (*superglue*)
-* [Ethernet Cables 3'](https://www.newegg.com/Product/ComboDealDetails?ItemList=Combo.4307102&quicklink=true)
-* [6-outlet power strip](https://www.newegg.com/apc-pe63-nema-5-15r/p/1B4-0052-000C2?Description=power%20strip&cm_re=power_strip-_-1B4-0052-000C2-_-Product&quicklink=true)
-* [Extension cords](https://www.newegg.com/black-monoprice-6-00-ft-others/p/0N6-01B8-002D6)
-* [PoE Injector/Splitter](https://www.newegg.com/p/2WG-00DK-00004)
-* [Ethernet to Ethernet adapter](https://www.newegg.com/p/0Y3-02J6-00001)
-* [USB Type C to Ethernet adapter](https://www.ebay.com/itm/132225990432?epid=910384900&hash=item1ec9487f20:g:FhgAAOSwqiVdyN)
+### Equipo de protección personal
+- Gafas de seguridad
+- Guantes de trabajo
+- Mascarillas KN95
+- Botiquín de primeros auxilios
diff --git a/docs/es/installations/installations.md b/docs/es/installations/installations.md
index 48bc54a..82b791b 100644
--- a/docs/es/installations/installations.md
+++ b/docs/es/installations/installations.md
@@ -1,78 +1,109 @@
---
-Title: Instalación de antenas
-
+title: Descripción general de la instalación
---
-# Instalación de antenas
-Philly Community Wireless se ha asociado con PhillyWisper para instalar antenas para la red wifi gratuita en los tejados del barrio de Norris Square Park. PhillyWisper es un proveedor de servicios de Internet inalámbrico (WISP), lo que significa que nuestro proyecto ofrece Internet a nuestros clientes a través de la tecnología de radio.
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../installations/installations/) es la referencia.
-## Proceso de instalación en la azotea
+# Descripción general de la instalación
-La mayoría de las instalaciones se realizaron en el siguiente orden:
+Philly Community Wireless se ha asociado con [**PhillyWisper**](https://phillywisper.net/) para instalar antenas para nuestra red wifi gratuita en azoteas de los vecindarios de Norris Square, Fairhill y Kensington. PhillyWisper es un proveedor de servicios de Internet inalámbrico (WISP), lo que significa que nuestro proyecto lleva Internet a nuestros clientes en la "última milla" mediante tecnología de radio.
-1. Examine el edificio y la azotea para evaluar la línea de visión (LOV) de la torre de origen de la ubicación alta para la señal de banda ancha.
-2. Instale la antena en la azotea y conecte el cable al edificio.
-3. Configure el router wifi y los kits de malla (para obtener más información, consulte nuestra guía [Configurar AP-Mesh](../device-configuration/configure-ap-mesh.md) y nuestra guía [Configurar enrutadores ERX](../device-configuration/configure-edgerouter-x.md)).
-4. Es posible que instale una antena montada en la pared para propagar la señal por la calle.
+Philly Community Wireless busca construir tecnologías de redes de malla inalámbricas que sean propiedad de la comunidad y operadas por ella. Esta página describe nuestro proceso de instalación y el tipo de red que intentamos construir en una amplia zona de la ciudad. En una red doméstica típica, todos los ["puntos de acceso" (APs)](https://en.wikipedia.org/wiki/Wireless_access_point) están conectados por cable Ethernet a su router para crear una red de área local inalámbrica. En una red de malla, los puntos de acceso no solo pueden estar conectados por cable, sino que también pueden conectarse entre sí de forma inalámbrica. Esto permite compartir una sola conexión a Internet con mucha menos infraestructura y mano de obra que si se conectara cada AP por cable.
-## Duración de las instalaciones de antenas
+## Proceso de instalación en la azotea
+
+La mayoría de las instalaciones se realizan en el siguiente orden:
-Normalmente, las instalaciones tardan entre dos y cuatro horas en completarse, pero en algunos casos pueden tardar más. El proceso de instalación completo, desde una antena en el techo hasta un kit de malla montado en la pared, puede implicar 2-3 visitas, cada una de las cuales implica una o dos horas de trabajo.
+1. **Evaluación del edificio**: recibimos una nueva dirección. Verificamos si la dirección tiene [línea de visión (LoS)](https://en.wikipedia.org/wiki/Line-of-sight_propagation) con un sitio alto de PhillyWisper usando Google Earth y otras herramientas de mapas, y hacemos evaluaciones del edificio tanto a distancia como en persona para elaborar un plan de instalación. Para obtener más información, consulte la página [Evaluación del edificio](buildingassessment.md).
+2. **Planificación de la instalación**: si hay LoS, nos comunicamos con el residente o la organización comunitaria para conocer sus necesidades de conectividad, así como las de sus vecinos y de la zona en general. Esto nos ayuda a decidir qué tipo de puntos de acceso y equipos de red llevar, y cuánto cable vamos a necesitar. Una vez definida la logística de la instalación inicial, ¡se fija la fecha de instalación!
+3. **Establecer el enlace ascendente**: el día de la instalación, PCW comienza instalando la radio de enlace ascendente (uplink), por lo general una [LiteBeam](https://store.ui.com/us/en/products/litebeam-5ac), apuntada hacia un sitio alto de PhillyWisper. Esta radio proporciona la conexión a Internet.
+4. **Instalar los puntos de acceso**: una vez establecido el enlace ascendente, podemos empezar a tender cable por el techo o por dentro del edificio e instalar puntos de acceso wifi según se necesiten, ya sea en interiores o en exteriores.
-# Hardware para la instalación
+En las instalaciones residenciales, o bien transmitimos una red privada para el residente desde los mismos puntos de acceso que transmiten la red pública de PCW, o bien le proporcionamos un router adicional para que tenga su propia red privada, que obtiene su enlace ascendente de la red de PCW.
-Las instalaciones en la azotea constan de una antena en la azotea, un inyector de alimentación a través de Ethernet, un router y un punto de acceso de malla. Philly Community Wireless y PhillyWisper utilizan principalmente radios y equipos de red Ubiquiti. Como cada techo es diferente, la instalación se personaliza para cada ubicación para garantizar la colocación más segura de acuerdo con los estándares del sector.
+A continuación se muestra un diagrama del sistema resultante. Pegados a la silueta de la casa y dentro de ella aparecen los dispositivos de exterior y de interior que PCW instalará para usted. Las siguientes secciones describen con más detalle nuestros métodos de instalación.
-En general, instalamos una antena Ubiquiti LiteBeam en el techo de la casa, que recibe la señal de una torre PhillyWisper. La antena se conecta al hogar mediante un cable Ethernet. Actualmente, esta parte de la instalación debe ser completada por un técnico de PhillyWisper. Para fines de instalación, esto significa que los técnicos de PhillyWisper tendrán que montar una antena de radio pequeña (aproximadamente 14 x 11 x 11 pulgadas) a la altura del techo y apuntar con precisión a la torre más cercana.
+
+
+ Diagrama general de la instalación
+
-PhillyWisper se esfuerza al máximo por impactar los edificios durante la instalación. Utilizan técnicas no invasivas al montar la radio (consulte las imágenes adjuntas de las distintas técnicas de montaje que aparecen a continuación). Nunca penetran en el sistema de techado mismo y ellos intentan y utilizan estructuras preexistentes (chimeneas, tubos de ventilación, etc) cuando es posible.
+## Duración de las instalaciones de antenas
-Si las estructuras preexistentes no son una opción, utilizarán un soporte de techo no penetrante, que se pesa correctamente y descansa sobre una alfombrilla de goma en la parte superior de su techo. A continuación, aseguran un cable de red estabilizado a los rayos UV para exteriores desde la radio del techo, hacia abajo a lo largo del exterior del edificio y el interior donde se ubicará el router WiFi.
+Por lo general, las instalaciones tardan entre dos y cuatro horas, pero en algunos casos pueden tardar más. El proceso de instalación completo, desde la antena en la azotea hasta un kit de malla montado en la pared, puede requerir 2 o 3 visitas, cada una de una o dos horas de trabajo.
-Tanto Philly Community Wireless y PhillyWisper como la de la comunidad Philly garantizan que el recorrido del cable sea lo más discreto posible y garantizan que el cable tenga mucha tensión para que no se solapa con el viento. Si hay alguna penetración preexistente que entra en el edificio de ISP anteriores, utilizarán eso si es posible y calafatearás cuando termine.
+## Hardware para la instalación
-## Ejemplos de instalación
+
+
+
+
+ LiteBeam (aprox. 14 x 11 x 11 pulgadas) montada en una chimenea con un soporte tipo J (J-arm)
+
-### Soportes de techo no penetrantes
+Por lo general, una instalación de Internet consiste en una antena en la azotea, un inyector PoE (alimentación a través de Ethernet), un router y un punto de acceso wifi (normalmente, todos son equipos de red Ubiquiti). Durante la instalación, PhillyWisper y Philly Community Wireless hacen todo lo posible por afectar los edificios lo menos posible. En cada lugar, adaptamos nuestro trabajo de instalación para que la colocación de los equipos de red sea lo menos invasiva y lo más segura posible, de acuerdo con los estándares de la industria.
-Utilizamos soportes de techo no penetrantes (NPRM). Una alfombra de goma gruesa se coloca debajo del NPRM para proteger el techo. Los bloques de cemento se utilizan como lastre para asegurar el NPRM:
+En la mayoría de los lugares, primero instalamos una antena de radio Ubiquiti LiteBeam en el techo de la casa, que recibe la señal de un sitio alto cercano administrado por PhillyWisper. Para instalar la antena en la azotea, los técnicos de PhillyWisper suben a un punto alto y montan la pequeña antena de radio (vea más abajo las imágenes de distintas técnicas de montaje), que apuntan con precisión hacia la torre más cercana. Al montar la antena nunca perforamos el sistema de techado y, siempre que es posible, aprovechamos estructuras existentes (chimeneas, tubos de ventilación, etc.). Si no es posible usar estructuras existentes, utilizamos un soporte de techo no penetrante, que lleva el lastre adecuado y descansa sobre una alfombrilla de goma encima de su techo.
-
-
+La radio de la azotea se alimenta con un cable Ethernet apto para exteriores que baja por la fachada del edificio y entra en la casa (nuestros equipos usan PoE, así que podemos alimentar los dispositivos de exterior por Ethernet desde un tomacorriente interior). Nos aseguramos de que el recorrido del cable sea lo más discreto posible y de que el cable quede bien tensado para que no se sacuda con el viento. Si hay perforaciones existentes por donde entraban al edificio los cables de proveedores de Internet (ISP) anteriores, se usarán si es posible y se sellarán con masilla al terminar.
-### Antenas montadas en la pared
+## Ejemplos de instalación
-La siguiente imagen muestra dos mástiles montados en la pared con radios, junto con un interruptor exterior y una caja de conexiones.
+### Soportes de techo no penetrantes
-El mástil de la izquierda tiene una radio Ubiquiti AF-24 que funciona a 24 GHz y proporciona una conexión de retorno de 1,4 Gbps al centro de datos.
+Utilizamos soportes de techo no penetrantes (NPRM). Debajo del NPRM se coloca una alfombrilla gruesa de goma para proteger el techo, y se usan 4 bloques de cemento como lastre para asegurarlo.
-
-
-
-
+
+
+ Un soporte de techo no penetrante con una LiteBeam instalada
+
-El mástil de la derecha tiene radios PTMP con antenas de bocina simétricas. Las radios proporcionan servicio a clientes individuales.
+### Montaje en estructuras existentes del techo
-El dispositivo blanco cuadrado entre y debajo de los mástiles es un Ubiquiti EP-S16, un conmutador de red para exteriores. Se suministra alimentación de 54 V CC al EP-S16, que a su vez suministra alimentación a las radios mediante POE (alimentación de Ethernet).
+También solemos usar soportes tipo J (J-arm) o soportes que quedaron de instalaciones de telecomunicaciones anteriores (antiguas antenas parabólicas de satélite) para montar nuestros equipos.
-# Instalación de kit de malla para hosts de antena en la azotea
+
+
+
+
+ Una LiteBeam montada en un mástil previamente instalado en una chimenea
+
-Los anfitriones de las instalaciones en la azotea también albergará un router en la casa cerca de la ventana al frente de la casa. En algunos casos podemos instalar una antena montada en la pared en el exterior de la casa para propagar la señal de banda ancha a través del vecindario.
+## Descripción general de los puntos de acceso wifi
-Proporcionamos un kit con un inyector PoE y un AP de malla de orejas de conejo. Philly Community Wireless puede instalar el kit, o el residente puede instalar las orejas de conejo en cualquier lugar dentro de su casa, siempre y cuando otros puntos de acceso de malla estén dentro del alcance de radio (estamos planeando sugerir la entrada de la casa o el porche -- los puntos de acceso son impermeables).
+### Puntos de acceso wifi para exteriores
-## Descripción general del kit de malla
+Los anfitriones de antena también tendrán un router en su casa, cerca de la ventana del frente. En algunos casos, podemos instalar un punto de acceso montado en la pared exterior de la casa para propagar la señal de banda ancha por el vecindario.
-El cable Ethernet pasa a través de un inyector de alimentación a través de Ethernet (PoE), que añade alimentación a la señal que transporta el cable Ethernet y permite que los dispositivos de bajada se alimenten únicamente a través de Ethernet.
+### Descripción general del router y los puntos de acceso para interiores
-
+El cable Ethernet que baja de la azotea pasa por un inyector PoE, que añade alimentación eléctrica a la señal que el cable ya transporta. Así es como la antena de la azotea funciona con un tomacorriente interior común.
-El cable Ethernet alimentado está conectado a un Ubiquiti EdgeRouter-X (o posiblemente a otro router en el futuro) configurado para admitir redes de malla. El router gestiona el tráfico de cada uno de los puntos de acceso (AP) con los que está conectado en malla.
+
+
+
-
+El cable Ethernet alimentado se conecta a un Ubiquiti EdgeRouter-X (o posiblemente a otro router en el futuro) configurado para admitir redes de malla. El router gestiona el tráfico de cada uno de los puntos de acceso (APs) con los que está conectado en malla.
-Por último, un Ubiquiti Mesh AP (“orejas de conejito” porque miren a ellos!) está conectado al router y permite que los dispositivos de su rango de señal de radio se conecten a la red. Las orejas de conejito deben instalarse en una ubicación que sea radiovisible para los puntos de acceso de malla en las instalaciones domésticas a su alcance.
+
+
+ Ubiquiti EdgeRouterX
+
-
+Por último, un AP de malla Ubiquiti (las "orejas de conejo"; ¡mírelo y verá por qué!) se conecta al router y permite que los dispositivos dentro del alcance de su señal de radio se conecten a la red. Las orejas de conejo deben instalarse en un lugar con visibilidad de radio hacia los APs de malla de las instalaciones domésticas que estén a su alcance.
-Para obtener más información sobre el kit de malla, consulte nuestra guía [Configurar AP-Mesh](../device-configuration/configure-ap-mesh.md)
+
+
+ Un Unifi UAP-AC-Mesh, conocido como "orejas de conejo"
+
diff --git a/docs/es/installations/solar.md b/docs/es/installations/solar.md
new file mode 100644
index 0000000..d51184b
--- /dev/null
+++ b/docs/es/installations/solar.md
@@ -0,0 +1,66 @@
+---
+title: Nodos solares de malla
+---
+
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../installations/solar/) es la referencia.
+
+# Descripción general de los nodos solares de malla
+
+Philly Community Wireless apoya activamente espacios verdes sostenibles enfocados en la conservación ambiental y el uso eficiente de los recursos. Con nodos solares autónomos (sin conexión a la red eléctrica) diseñados por [Holobiont Lab](https://holobiontlab.org/), hemos instalado puntos de acceso wifi alimentados por energía solar en huertos y otros espacios donde la electricidad es costosa o no está fácilmente disponible. Philly Community Wireless también está trabajando para alimentar sensores inteligentes, como el [monitor de calidad del aire PurpleAir](https://www.purpleair.com/products/classic-plus-air-quality-monitor), con nodos solares modificados para dar seguimiento a la salud ambiental.
+
+## Especificaciones del hardware
+
+* Caja para exteriores resistente a la intemperie
+* Panel solar de 25-50W
+* Cualquier combinación de baterías reutilizadas adecuadas, con voltaje nominal de 12V
+* Un controlador de carga
+* Un desconectador por baja temperatura (según el tipo de batería)
+* Un convertidor elevador de 12V a 24V y 3A
+* Un nodo de malla: para empezar, el punto de acceso de malla Ubiquiti de 24V
+
+## Instalaciones
+
+En 2021, PCW instaló un nodo solar de malla en Colobo Gardens, de Norris Square Neighborhood Projects. Por lo general, las baterías duran por lo menos un par de años antes de necesitar reemplazo. El punto de acceso está en la parte superior de un mástil de bambú, a una altura suficiente para sobrepasar las estructuras del huerto, con el panel solar y la caja montados debajo.
+
+
+
+ El nodo solar de malla completo en Colobo Gardens: el punto de acceso en lo alto del mástil de bambú, con el panel solar montado en el techo debajo
+
+
+
+
+ El panel solar en su soporte inclinado en el borde del techo, con el cableado que baja hasta la caja
+
+
+## La caja de la batería solar
+
+La caja resistente a la intemperie contiene todo lo que no es el panel ni el punto de acceso: la batería, el controlador de carga y el inyector PoE (alimentación a través de Ethernet), que lleva la alimentación hasta el AP a través de un solo cable Ethernet.
+
+
+
+ El interior de la caja en Colobo Gardens
+
+
+## Solución de problemas de los nodos solares de malla
+
+Si necesita más ayuda para resolver problemas, consulte la sección 'Troubleshooting' (solución de problemas, pág. 12) de la [Meshbox Documentation](https://holobiontlab.org/docs/meshBoxDocumentation.pdf) (en inglés). La [documentación de meshbox](https://holobiontlab.org/r&d/meshbox) de Holobiont Lab explica con más detalle el diseño en el que se basan estos nodos.
+
+Los problemas comunes incluyen:
+
+* Descarga de la batería: la batería LiFePO4 debe marcar entre 12.5V y 14.6V.
+ * Si marca menos de 12.5V, el sistema de gestión de la batería se apagará para ahorrar energía.
+* Las conexiones entre la caja y el controlador de carga, así como las conexiones entre el controlador de carga y el AP.
+ * Debe haber una luz **roja** en el controlador de carga y una luz **verde** en el inyector PoE.
+* Temperaturas bajas o mal tiempo
+
+## Más recursos
+
+Consulte [Recursos de tecnología verde](green-technology.md) para conocer programas solares, organizaciones de agricultura urbana e iniciativas de monitoreo ambiental en Filadelfia.
diff --git a/docs/es/resources.md b/docs/es/resources.md
index 9158485..7f6682f 100644
--- a/docs/es/resources.md
+++ b/docs/es/resources.md
@@ -1,51 +1,70 @@
---
-Title: Recursos Académicos
+title: Recursos
---
-# Recursos Académicos
-## Historia de la tecnología comunitaria en Philadelphia
+
+!!! note "Traducción preliminar"
+ Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../resources/) es la referencia.
-Breitbart, Joshua, Naveen Lakshmipathy, and Sascha D. Meinrath. “[The Philadelphia Story: Learning from a Municipal Wireless Pioneer](https://technical.ly/wp-content/uploads/2017/03/wireless-philadelphia-report-breitbart-et-al.pdf).” Washington DC: New America Foundation, December 2007.
+# Recursos
-Dunbar-Hester, Christina. _Low Power to the People: Pirates, Protest, and Politics in FM Radio Activism._ MIT Press, 2014.
+## Documentación de otros proyectos
+
+[Documentación de NYC Mesh](https://wiki.nycmesh.net/)
+
+[Documentación de Toronto Mesh](https://docs.tomesh.net/)
+
+## Videos
-
+[Explicación de los puntos de intercambio de Internet (Internet Exchange Points)](https://www.youtube.com/watch?v=bJG3UFpaqmE)
-## Currículo
+## Currículos y guías
-[Teaching Community Technology Handbook](https://detroitcommunitytech.org/teachcommtech) \[pdf\], Detroit Community Technology Project
+[Start Your Own ISP](https://startyourownisp.com), Graham Castleton
-> designed using a "popular education method grounded in the history of Civil Rights-era Citizenship Schools and Paulo Freire’s _Pedagogy of the Oppressed._ . . . \[a\] people-guided approach to bring tech education to communities that have been harmed and oppressed by technology."
+[Teaching Community Technology Handbook](https://detroitcommunitytech.org/teachcommtech) (PDF), Detroit Community Technology Project
+
+> diseñado con un "método de educación popular basado en la historia de las Escuelas de Ciudadanía (Citizenship Schools) de la época de los Derechos Civiles y en la _Pedagogía del oprimido_ de Paulo Freire. . . . \[un\] enfoque guiado por la gente para llevar la educación tecnológica a comunidades que han sido perjudicadas y oprimidas por la tecnología".
[Neighborhood Network Construction Kit: Do-it-ourselves Guide to Community Networks](https://communitytechnology.github.io/docs/cck/index.html)
-> originally released as [Commotion Construction Kit](https://web.archive.org/web/20240625185349/https://commotionwireless.net/docs/cck/), this tutorial was co-designed by New America's Open Technology Institute, The Work Department, Allied Media Projects, and the Detroit Community Technology Project
+> publicado originalmente como [Commotion Construction Kit](https://web.archive.org/web/20240625185349/https://commotionwireless.net/docs/cck/), este tutorial fue diseñado en conjunto por el Open Technology Institute de New America, The Work Department, Allied Media Projects y el Detroit Community Technology Project
[Portable Network Kit Setup Guide](https://www.communitytechny.org/portable-network-kits), Community Tech NY
-[Wireless Networking in the Developing World](http://wndw.net). 3rd Edition. Copenhagen, 2013.
+[Wireless Networking in the Developing World](http://wndw.net). 3.ª edición. Copenhague, 2013.
[The Community Network Manual: How to Build the Internet Yourself](https://bibliotecadigital.fgv.br/dspace/handle/10438/25696)
[Meshnet DWeb Camp 2019](https://dweb-camp-2019.github.io/meshnet/)
-
-
## Modelos de política y organización
[Detroit Digital Stewards Program](https://web.archive.org/web/20200519201019/https://www.alliedmedia.org/dctp/digitalstewards)
-National Urban League's [Lewis Latimer Plan for Digital Equity and Inclusion](https://nul.org/news/national-urban-league-unveils-new-framework-bridge-digital-divide)
+El [Lewis Latimer Plan for Digital Equity and Inclusion](https://nul.org/news/national-urban-league-unveils-new-framework-bridge-digital-divide) (plan para la equidad y la inclusión digital) de la National Urban League
+
+Nicol Turner Lee (Brookings) propone un "[Tech New Deal](https://www.brookings.edu/blog/techtank/2021/01/12/why-america-needs-a-tech-new-deal-to-build-back-better/)" (un "nuevo trato" tecnológico)
-Nicol Turner Lee (Brookings) proposing a “[Tech New Deal](https://www.brookings.edu/blog/techtank/2021/01/12/why-america-needs-a-tech-new-deal-to-build-back-better/)"
+## Historia de la tecnología comunitaria en Philadelphia
-
+Breitbart, Joshua, Naveen Lakshmipathy, and Sascha D. Meinrath. “[The Philadelphia Story: Learning from a Municipal Wireless Pioneer](https://technical.ly/wp-content/uploads/2017/03/wireless-philadelphia-report-breitbart-et-al.pdf).” Washington DC: New America Foundation, December 2007.
+
+Dunbar-Hester, Christina. _Low Power to the People: Pirates, Protest, and Politics in FM Radio Activism._ MIT Press, 2014.
## Lecturas adicionales
+Belli, Luca. "The Community Network Manual - How to Build the Internet Yourself," 2018. .
+
+Belli, Luca, ed. "Community Networks: The Internet by the People, for the People. Official Outcome of the UN IGF Dynamic Coalition on Community Connectivity," 2017. https://www.apc.org/en/pubs/community-networks-internet-people-people. (PDF)
+
Byrum, Greta. “[Building the People’s Internet](https://urbanomnibus.net/2019/10/building-the-peoples-internet/).” _Urban Omnibus_, October 2, 2019.
+Butler, Jane, ed. Wireless Networking in the Developing World: a Practical Guide to Planning and Building Low-Cost Telecommunications Infrastructure. 3rd ed. S.l.: s.n., 2013.
+
+OTI, New America, The Work Department, and DCTP. "Neighborhood Network Construction Kit: Do-It-Ourselves Guide to Community Networks." .
+
Park, Claire. “[Community Broadband: The Fast, Affordable Internet Option That’s Flying Under the Radar](https://www.newamerica.org/oti/reports/community-broadband/).” Washington D.C.: New America Foundation, May 19, 2020.
Rey-Moreno, Carlos. “[Supporting the Creation and Scalability of Affordable Access Solutions: Understanding Community Networks in Africa](https://www.internetsociety.org/resources/doc/2017/supporting-the-creation-and-scalability-of-affordable-access-solutions-understanding-community-networks-in-africa/).” Internet Society, May 2017.
@@ -57,15 +76,3 @@ Shaffer, Gwen. “[Common Sense: An Examination of Three Los Angeles Community W
Solomon, Rory. [_Meshiness: Mesh Networks and the Politics of Connectivity_](http://search.proquest.com/pqdtglobal/docview/2408892960/abstract/479AB38D8B044610PQ/1)_._ Ph.D., New York University, 2020.
Thakur, Dhanaraj, and Teddy Woodhouse. “[Meaningful Connectivity: A New Standard to Raise the Bar for Internet Access](https://web.archive.org/web/20260220230151/https://a4ai.org/meaningful-connectivity/).” Alliance for Affordable Internet, 2020.
-
-
-
-## Prensa local
-
-Graham, Kristen A. “[Philly Schools Chief Says Internet Providers Refuse to Open Their Networks so Students Can Access Education](https://www.inquirer.com/education/internet-access-philadelphia-coronavirus-comcast-budget-council-hite-school-district-20200520.html).” _The Philadelphia Inquirer,_ May 20, 2020.
-
-Gross, Paige. “[A Digital Literacy Alliance Grant Is Creating Roles to Help Residents Access and Use Tech during the Pandemic](https://technical.ly/philly/2020/05/29/digital-literacy-alliance-grant-digital-navigator-help-residents-access-use-tech-during-pandemic/).” _Technical.Ly Philly,_ May 29, 2020, sec. Civic.
-
-Hetrick, Christian, and Dylan Purcell. “[Thousands of Philly Students Are Stuck at Home with No Computer or Internet after Coronavirus Closed Schools](https://www.inquirer.com/education/coronavirus-students-digital-divide-philadelphia-comcast-20200403.html).” _The Philadelphia Inquirer,_ April 3, 2020.
-
-Noor, Jaisal. “[Baltimore City Students Demand Comcast Increase Internet Speed During Pandemic](https://baltimorebeat.com/baltimore-city-students-demand-comcast-increase-internet-speed-during-pandemic/).” _Baltimore Beat_, May 26, 2020.
diff --git a/docs/es/software-infrastructure/overview.md b/docs/es/software-infrastructure/overview.md
new file mode 100644
index 0000000..766a89a
--- /dev/null
+++ b/docs/es/software-infrastructure/overview.md
@@ -0,0 +1 @@
+# Descripción general
diff --git a/docs/es/wireless/fixed-wireless.md b/docs/es/wireless/fixed-wireless.md
new file mode 100644
index 0000000..789d0c6
--- /dev/null
+++ b/docs/es/wireless/fixed-wireless.md
@@ -0,0 +1 @@
+# Inalámbrico fijo
diff --git a/docs/es/wireless/wifi.md b/docs/es/wireless/wifi.md
new file mode 100644
index 0000000..67736a7
--- /dev/null
+++ b/docs/es/wireless/wifi.md
@@ -0,0 +1 @@
+# WiFi
diff --git a/hooks/glossary_tooltips.py b/hooks/glossary_tooltips.py
index 3f0c78d..4e5a917 100644
--- a/hooks/glossary_tooltips.py
+++ b/hooks/glossary_tooltips.py
@@ -2,7 +2,9 @@
The definitions live in `includes/abbreviations.md` so they can be edited
without touching Python. Every page gets them appended, and the `abbr`
-extension turns each occurrence of a term into a tooltip.
+extension turns each occurrence of a term into a tooltip. Pages in another
+language's folder (e.g. `es/`) use `includes/abbreviations..md` when it
+exists, so Spanish pages get Spanish definitions.
Marking up *every* occurrence underlines a common acronym dozens of times on
a long page, so `on_post_page` unwraps all but the first of each term.
@@ -11,13 +13,17 @@
import re
from pathlib import Path
-ABBREVIATIONS = Path(__file__).parent.parent / "includes" / "abbreviations.md"
+INCLUDES = Path(__file__).parent.parent / "includes"
+ABBREVIATIONS = INCLUDES / "abbreviations.md"
ABBR = re.compile(r'(?P[^<]*)')
def on_page_markdown(markdown, page, config, files):
- return markdown + "\n\n" + ABBREVIATIONS.read_text()
+ lang = page.file.src_uri.split("/", 1)[0]
+ translated = INCLUDES / f"abbreviations.{lang}.md"
+ source = translated if translated.exists() else ABBREVIATIONS
+ return markdown + "\n\n" + source.read_text()
def on_post_page(output, page, config):
diff --git a/includes/abbreviations.es.md b/includes/abbreviations.es.md
new file mode 100644
index 0000000..6dfb6ab
--- /dev/null
+++ b/includes/abbreviations.es.md
@@ -0,0 +1,17 @@
+*[LoS]: Línea de visión — una vista despejada entre una antena sectorial de PhillyWisper y la azotea donde instalamos un radio.
+*[NPRM]: Soporte de techo no penetrante — un soporte con lastre que nos permite instalar sin perforar el techo.
+*[Non-Pen]: Soporte de techo no penetrante — un soporte con lastre que nos permite instalar sin perforar el techo.
+*[PoE]: Alimentación a través de Ethernet — enviar energía eléctrica junto con los datos por un cable Ethernet, para que un dispositivo exterior no necesite su propio tomacorriente.
+*[ERX]: EdgeRouter X — el router de Ubiquiti que PCW usa como switch, para mover datos entre dispositivos.
+*[PtP]: Punto a punto — un enlace entre exactamente dos nodos que se comunican directamente.
+*[PtMP]: Punto a multipunto — un punto de acceso central que da servicio a varias estaciones remotas.
+*[AP]: Punto de acceso — un dispositivo inalámbrico que sirve de portal para que otros dispositivos se unan a la red.
+*[APs]: Punto de acceso — un dispositivo inalámbrico que sirve de portal para que otros dispositivos se unan a la red.
+*[WISP]: Proveedor de internet inalámbrico — un proveedor que ofrece la última milla por radio en lugar de cable o fibra.
+*[MDUs]: Edificios multifamiliares — edificios de apartamentos u otras propiedades con varias viviendas.
+*[MDU]: Edificio multifamiliar — un edificio de apartamentos u otra propiedad con varias viviendas.
+*[LAN]: Red de área local — una red que cubre un edificio o sitio.
+*[RF]: Radiofrecuencia.
+*[GFCIs]: Tomacorrientes GFCI (interruptor de circuito por falla a tierra) — cortan la corriente cuando detectan una falla; son obligatorios para la energía en exteriores.
+*[GFCI]: Tomacorriente GFCI (interruptor de circuito por falla a tierra) — corta la corriente cuando detecta una falla; es obligatorio para la energía en exteriores.
+*[SSID]: Identificador de red — el nombre que transmite una red wifi.
diff --git a/mkdocs.yml b/mkdocs.yml
index 8a83966..0ce501a 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -32,27 +32,28 @@ hooks:
# Draft pages still being worked on.
# Built with `mkdocs serve` for dev. purposes, but excluded from prod builds with `mkdocs build`
-# When a page is ready, delete its line here, add it to `nav:` below in the proper place, and
-# remove its entry from mkdocs.dev.yml's nav
+# Each line starts with `/*/` so it matches the page in every language folder (en/, es/).
+# When a page is ready, delete its line here and add it to `nav:` below in the proper place.
+# mkdocs.dev.yml's nav already lists it, so leave that file as is.
draft_docs: |
- /en/faqs.md
- /en/device-configuration/configure-edgerouter-ansible.md
- /en/device-configuration/troubleshoot-connection.md
- /en/device-configuration/unpoller.md
- /en/device-configuration/useful-software.md
- /en/device-configuration/wireless-settings.md
- /en/installations/handbook/assessment-planning.md
- /en/installations/handbook/etiquette.md
- /en/installations/handbook/install-day-and-maintenance.md
- /en/installations/handbook/overview.md
- /en/installations/handbook/phases-overview.md
- /en/installations/handbook/risks-rooftop-ladder-drill.md
- /en/installations/handbook/risks-weather-environment.md
- /en/installations/handbook/safety-basics.md
- /en/installations/handbook/safety-buildings-electrical.md
- /en/software-infrastructure/overview.md
- /en/wireless/fixed-wireless.md
- /en/wireless/wifi.md
+ /*/faqs.md
+ /*/device-configuration/configure-edgerouter-ansible.md
+ /*/device-configuration/troubleshoot-connection.md
+ /*/device-configuration/unpoller.md
+ /*/device-configuration/useful-software.md
+ /*/device-configuration/wireless-settings.md
+ /*/installations/handbook/assessment-planning.md
+ /*/installations/handbook/etiquette.md
+ /*/installations/handbook/install-day-and-maintenance.md
+ /*/installations/handbook/overview.md
+ /*/installations/handbook/phases-overview.md
+ /*/installations/handbook/risks-rooftop-ladder-drill.md
+ /*/installations/handbook/risks-weather-environment.md
+ /*/installations/handbook/safety-basics.md
+ /*/installations/handbook/safety-buildings-electrical.md
+ /*/software-infrastructure/overview.md
+ /*/wireless/fixed-wireless.md
+ /*/wireless/wifi.md
plugins:
- search
@@ -72,11 +73,11 @@ plugins:
nav_translations:
# TODO: Spanish review of the nav labels added below — for a fluent speaker at PR review.
Home: Inicio
- For Antenna Hosts: Para anfitriones de antenas
+ For Antenna Hosts: Para anfitriones de antena
For Volunteers: Para voluntarios
For network users: Para usuarios de la red
Installations: Instalaciones
- Installation Overview: Descripción general
+ Installation Overview: Descripción general de la instalación
Building Assessment: Evaluación del edificio
Building Assessments: Evaluación del edificio
Configure routers running EdgeOS: Configurar routers con EdgeOS
@@ -84,7 +85,7 @@ plugins:
Troubleshoot Unifi Devices: Solución de problemas de dispositivos Unifi
Hardware: Hardware
Solar: Solar
- Solar Mesh Nodes: Nodos solares
+ Solar Mesh Nodes: Nodos solares de malla
Access Point Placement: Ubicación de los puntos de acceso
Green Technology Resources: Recursos de tecnología verde
Networking and Device Configuration: Redes y configuración de dispositivos
@@ -93,10 +94,31 @@ plugins:
Configure Unifi APs: Configurar APs Unifi
Configure IoT Devices: Configurar dispositivos IoT
Connecting to the network: Conectarse a la red
- Troubleshoot Devices: Solución de problemas
+ Troubleshoot Devices: Solución de problemas de dispositivos
Resources: Recursos
Glossary: Glosario
- Further reading: Más recursos
+ Further reading: Lecturas adicionales
+ # Labels only in mkdocs.dev.yml's nav, for draft pages.
+ Overview: Descripción general
+ Install Phases Overview: Fases de instalación
+ Assessment & Planning: Evaluación y planificación
+ Etiquette On Site: Normas de conducta en el sitio
+ Install Day & Maintenance: Día de instalación y mantenimiento
+ Safety: Seguridad
+ Safety Basics: Seguridad básica
+ Building & Electrical Safety: Seguridad en edificios y eléctrica
+ "Rooftop, Ladder & Drill Safety": Seguridad en azoteas, escaleras y taladros
+ Weather & Environmental Risks: Riesgos climáticos y ambientales
+ Wireless: Inalámbrico
+ Fixed Wireless: Inalámbrico fijo
+ WiFi: Wifi
+ Automated configuration (Ansible): Configuración automatizada (Ansible)
+ Troubleshoot Your Connection: Solución de problemas de su conexión
+ Wireless Settings: Configuración inalámbrica
+ Useful Software: Software útil
+ Unpoller: Unpoller
+ Software & Infrastructure: Software e infraestructura
+ FAQs: Preguntas frecuentes
nav:
- Home: index.md
@@ -138,3 +160,8 @@ markdown_extensions:
- pymdownx.details
- pymdownx.highlight
- pymdownx.superfences
+
+# Report links to headings that don't exist (`page.md#missing-heading`), so
+# `mkdocs build --strict` fails on them like it does on links to missing pages.
+validation:
+ anchors: warn
diff --git a/readme-imgs/sample-new-page-in-nav.png b/readme-imgs/sample-new-page-in-nav.png
deleted file mode 100644
index e754ffa..0000000
Binary files a/readme-imgs/sample-new-page-in-nav.png and /dev/null differ
diff --git a/readme-imgs/sample-new-page.png b/readme-imgs/sample-new-page.png
deleted file mode 100644
index 1a617c7..0000000
Binary files a/readme-imgs/sample-new-page.png and /dev/null differ
+ 
+ 
+
+
+
+Los AP de malla han tenido un comportamiento inesperado incluso recién sacados del empaque, por lo que se recomienda restablecerlos a la configuración de fábrica antes de continuar.
+
+1. Con el clip, presione el botón de reinicio (reset) que está en la parte inferior del AP de malla hasta que haga clic.
+2. Manténgalo presionado durante 5 segundos.
+3. La luz de estado del AP debería parpadear y luego apagarse mientras el dispositivo se reinicia. Cuando vuelva a encenderse, debería quedar en blanco fijo, lo que indica que el restablecimiento se completó correctamente.
+4. Para obtener más información sobre las luces de estado, consulte [Patrones de color de los LED de los dispositivos UniFi](troubleshoot-devices.md#indicadores-led-de-estado-de-los-ap-unifi)
+
+Nota: El AP de malla puede tardar unos minutos en iniciarse después de conectarlo o restablecerlo, así que espere hasta que la luz de estado esté en blanco fijo.
+
+
+### 2. Conecte el AP a su computadora
+
+Necesitamos conectar el dispositivo a nuestra computadora y averiguar su dirección IP, y al mismo tiempo asegurarnos de que también tenga una ruta a Internet.
+
+!!! info ""
+ Normalmente, cualquier dispositivo en su red recibe una dirección IP mediante el protocolo de configuración dinámica de host (Dynamic Host Configuration Protocol, o DHCP). Esto permite que su router sepa con qué dispositivo se está comunicando en su red. Aunque los AP Unifi se restablecen a `192.168.1.20`, si el AP ya se ha configurado antes, es posible que reciba otra dirección IP.
+
+Los AP de malla Unifi deberían restablecerse automáticamente a `192.168.1.20`, así que primero puede pasar directamente al [paso 3](#3-conectese-al-ap-por-ssh) y ver si funciona el comando `ssh`.
+
+Si la dirección IP del AP de malla no es `192.168.1.20`, hay dos formas de encontrarla:
+
+
+ 
- 
+ 
+ 
+ 
+ 
+ 
+ 
- 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+
+ 
+ 
+ 
+ 
+