Skip to content

Development environment setup#32

Merged
rafaelstz merged 7 commits intomasterfrom
cursor/development-environment-setup-35d6
Feb 24, 2026
Merged

Development environment setup#32
rafaelstz merged 7 commits intomasterfrom
cursor/development-environment-setup-35d6

Conversation

@rafaelstz
Copy link
Copy Markdown
Member

@rafaelstz rafaelstz commented Feb 24, 2026

Update CI for HTML validation and add SEO improvements to enhance search engine visibility.

This PR implements several SEO best practices, including updating language attributes, adding hreflang and robots meta tags, removing deprecated meta keywords and IE8 shims, fixing heading hierarchy for better semantic structure, wrapping command examples in <code> tags, improving image alt text, and adding FAQ structured data. The CI workflow is also updated to perform HTML syntax validation, link checking, and other relevant tests instead of a Jekyll build.


Open in Web Open in Cursor 


Note

Medium Risk
Moderate risk due to replacing the existing CI build step with custom HTML/asset validation and large edits to the main index.html, which could cause CI false positives/negatives or unintended markup regressions.

Overview
Shifts GitHub Actions from a Jekyll Docker build to a static-site validation job that runs tidy HTML checks, validates sitemap.xml/JSON-LD syntax, checks robots.txt sitemap references, scans for TODO-style markers, and verifies local href/src targets exist.

Improves SEO/semantics in index.html by updating lang to pt-BR, adding robots + hreflang, expanding JSON-LD with an FAQPage, refining alt text, and updating various command examples/section markup (e.g., more consistent tab titles and <code> wrapping). Updates sitemap lastmod, adds small CSS helpers for the new markup, and adds AGENTS.md with local run/lint/CI notes.

Written by Cursor Bugbot for commit 0ced4c0. This will update automatically on new commits. Configure here.

cursoragent and others added 6 commits February 24, 2026 21:09
Co-authored-by: Rafael Corrêa Gomes <rafaelstz@users.noreply.github.com>
… data files

- Add _config.yml with centralized site metadata
- Add Gemfile with Jekyll 4.x and jekyll-seo-tag
- Add _layouts/default.html as base HTML layout
- Add _includes/ for reusable partials (head, header, nav, footer, scripts)
- Add _includes/sections/ with 13 content section files
- Add _data/navigation.yml to drive sidebar navigation via Liquid
- Refactor index.html to use Jekyll front matter and includes
- Update .gitignore for Jekyll build artifacts
- Update AGENTS.md with Jekyll-specific instructions

Co-authored-by: Rafael Corrêa Gomes <rafaelstz@users.noreply.github.com>
Remove all Jekyll files (_config.yml, _layouts/, _includes/, _data/, Gemfile)
and restore the original monolithic index.html and .gitignore.
Restore AGENTS.md to the original non-Jekyll version.

Co-authored-by: Rafael Corrêa Gomes <rafaelstz@users.noreply.github.com>
… Git

- Add git switch mention in git checkout section (Git 2.23+)
- Add content for git remote and git submodule sections
- Add content for Inspeção e Comparação: git show, log (advanced), diff (advanced), shortlog, describe
- Add content for Pacotes: git apply, cherry-pick, diff (patches), rebase, revert
- Add content for Debugando: git bisect, blame, grep
- Add content for Email: git am, apply, format-patch, send-email, request-pull
- Add content for Sistemas Externos: git svn, fast-import
- Add content for Administração: git clean, gc, fsck, reflog, filter-branch, instaweb, archive
- Add content for Servidor: git daemon, update-server-info
- Add content for Canalização de Código: all 16 plumbing commands
- Fix empty <li> bug in sidebar navigation
- Mention git filter-repo as modern replacement for filter-branch

Co-authored-by: Rafael Corrêa Gomes <rafaelstz@users.noreply.github.com>
Co-authored-by: Rafael Corrêa Gomes <rafaelstz@users.noreply.github.com>
CI changes:
- Replace Jekyll build with HTML syntax validation (tidy)
- Add broken internal link checker
- Add sitemap.xml well-formedness validation
- Add JSON-LD structured data syntax validation
- Add robots.txt validation
- Add TODO/FIXME marker check

SEO improvements:
- Change lang='pt' to lang='pt-BR' for correct locale targeting
- Add hreflang tag for pt-BR
- Add meta robots 'index, follow' tag
- Remove deprecated meta keywords tag (ignored by Google since 2009)
- Remove IE8 shims (HTML5 Shiv + Respond.js) - zero IE8 market share
- Fix heading hierarchy: replace h3 tab labels with span.tab-title
- Wrap 181 git command examples in <code> tags for semantic markup
- Improve logo alt text for image search and accessibility
- Add FAQ structured data (JSON-LD) for 6 common Git questions
- Update sitemap.xml lastmod to 2026-02-24
- Add .tab-title and .well code CSS rules

Co-authored-by: Rafael Corrêa Gomes <rafaelstz@users.noreply.github.com>
@cursor
Copy link
Copy Markdown

cursor bot commented Feb 24, 2026

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

Co-authored-by: Rafael Corrêa Gomes <rafaelstz@users.noreply.github.com>
@rafaelstz rafaelstz merged commit 33ba6ab into master Feb 24, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants