Skip to content

Update sc-install groups#207

Merged
gigeresk merged 3 commits intomainfrom
readme_cosmetic
Mar 22, 2026
Merged

Update sc-install groups#207
gigeresk merged 3 commits intomainfrom
readme_cosmetic

Conversation

@gigeresk
Copy link
Copy Markdown
Collaborator

@gigeresk gigeresk commented Mar 21, 2026

Summary by CodeRabbit

  • Documentation
    • Simplified installation command by removing the explicit FPGA argument
    • Clarified and renumbered steps in the embedded Python walkthrough; fixed spelling and grammar
    • Updated prerequisites list (removed standalone GHDL entry; standardized hyphenation for tool descriptions)
    • Improved link phrasing, example punctuation, and fixed license typo

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Mar 21, 2026

📝 Walkthrough

Walkthrough

Simplified README installation command (removed opensta arg), rewrote Python example comments, corrected typos and phrasing across examples and prerequisites, adjusted dependency list formatting; no code, API, or exported-entity changes.

Changes

Cohort / File(s) Summary
Documentation
README.md
Removed opensta argument from sc-install -group fpga examples; normalized Python walkthrough comments (removed numeric prefixes, fixed "compilatin"→"compilation"), changed heartbeat link phrasing to "can be found here", added trailing period to Ethernet bullet, removed standalone GHDL entry, hyphenation updates ("High-performance", "Production-grade"), and fixed "depedency"→"dependency".

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐇 I nibbled through README lines with care,

smoothed a command, tightened a pair.
Typos chased and commas aligned,
a tidy hop, a clearer find.
Docs now flourish — chew, then share.

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Update sc-install groups' accurately reflects the main change: removing the 'opensta' argument from the sc-install command in the README documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch readme_cosmetic

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Tip

You can make CodeRabbit's review stricter and more nitpicky using the `assertive` profile, if that's what you prefer.

Change the reviews.profile setting to assertive to make CodeRabbit's nitpick more issues in your PRs.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
README.md (1)

78-78: Use descriptive link text instead of "here".

The link text "here" is not descriptive and can be problematic for accessibility (screen readers) and SEO. Consider making the link text describe the destination.

♻️ Proposed fix for more descriptive link text
-> The required files can be found [here](https://github.com/siliconcompiler/logik/tree/main/examples/adder)
+> The required files can be found in the [adder example directory](https://github.com/siliconcompiler/logik/tree/main/examples/adder)

Alternatively:

-> The required files can be found [here](https://github.com/siliconcompiler/logik/tree/main/examples/adder)
+> [View the required files](https://github.com/siliconcompiler/logik/tree/main/examples/adder) in the examples directory

As per coding guidelines, this aligns with the markdownlint MD059 rule that recommends descriptive link text.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 78, Replace the non-descriptive link text "here" with a
descriptive phrase that explains the destination (e.g., "the adder example
files" or "the examples/adder directory") in the README link; locate the anchor
containing the text "here" and update its link text to a clear, accessible label
while keeping the same URL (the GitHub examples/adder link).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Line 38: Update the Installation section so the redundant explicit tool
argument is removed: change the command string "sc-install -group fpga opensta"
to "sc-install -group fpga" (so it matches the simplified usage shown as
"sc-install -group fpga"); locate and edit the occurrence in README.md where the
Installation example shows the longer command.

---

Nitpick comments:
In `@README.md`:
- Line 78: Replace the non-descriptive link text "here" with a descriptive
phrase that explains the destination (e.g., "the adder example files" or "the
examples/adder directory") in the README link; locate the anchor containing the
text "here" and update its link text to a clear, accessible label while keeping
the same URL (the GitHub examples/adder link).

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 101ae1c8-db23-429e-884d-3ddd401e7c28

📥 Commits

Reviewing files that changed from the base of the PR and between 23ec3dc and 94832ca.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

♻️ Duplicate comments (1)
README.md (1)

113-113: ⚠️ Potential issue | 🟡 Minor

Update command to match line 38 for consistency.

This line still shows sc-install -group fpga opensta, but line 38 was simplified to sc-install -group fpga (without the explicit opensta argument). Since the -group fpga already includes OpenSTA by default, the explicit argument is redundant. Update this line to match line 38.

🔧 Proposed fix
-sc-install -group fpga opensta
+sc-install -group fpga
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 113, Update the redundant command instance "sc-install
-group fpga opensta" in the README to match the simplified form used earlier by
changing it to "sc-install -group fpga"; locate the occurrence of the exact
string "sc-install -group fpga opensta" and replace it with "sc-install -group
fpga" so both instances are consistent.
🧹 Nitpick comments (1)
README.md (1)

78-78: Consider using more descriptive link text.

The link text "here" is generic. For better accessibility and clarity, consider using descriptive text such as "adder example files" or "example source files".

♻️ Proposed improvement
-> The required files can be found [here](https://github.com/siliconcompiler/logik/tree/main/examples/adder)
+> The required files can be found in the [adder example directory](https://github.com/siliconcompiler/logik/tree/main/examples/adder)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 78, Replace the generic link text "here" in the README.md
line pointing to
https://github.com/siliconcompiler/logik/tree/main/examples/adder with a
descriptive label like "adder example files" or "example source files" so the
link reads e.g. "The required files can be found in the adder example files"
(update the Markdown link text only, keeping the existing URL).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@README.md`:
- Line 113: Update the redundant command instance "sc-install -group fpga
opensta" in the README to match the simplified form used earlier by changing it
to "sc-install -group fpga"; locate the occurrence of the exact string
"sc-install -group fpga opensta" and replace it with "sc-install -group fpga" so
both instances are consistent.

---

Nitpick comments:
In `@README.md`:
- Line 78: Replace the generic link text "here" in the README.md line pointing
to https://github.com/siliconcompiler/logik/tree/main/examples/adder with a
descriptive label like "adder example files" or "example source files" so the
link reads e.g. "The required files can be found in the adder example files"
(update the Markdown link text only, keeping the existing URL).

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f094496d-026f-49aa-bea2-cf1f4cabddae

📥 Commits

Reviewing files that changed from the base of the PR and between 94832ca and 69e8201.

📒 Files selected for processing (1)
  • README.md

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
README.md (1)

8-8: Polish compound adjectives and dependency-license sentence.

These lines read better with standard hyphenation and a clearer final clause.

Suggested edit
-Logik is an open source FPGA tool chain with support for high level language parsing, synthesis, placement, routing, bitstream generation, and analysis. Users enter design sources, constraints, and compile options through a simple [SiliconCompiler](https://github.com/siliconcompiler/siliconcompiler/) Python API. Once setup is complete, automated compilation can be initiated with a single line run command. Logik relies on the [Logiklib](https://github.com/siliconcompiler/logiklib) project for all architecture and device descriptions.
+Logik is an open-source FPGA tool chain with support for high-level language parsing, synthesis, placement, routing, bitstream generation, and analysis. Users enter design sources, constraints, and compile options through a simple [SiliconCompiler](https://github.com/siliconcompiler/siliconcompiler/) Python API. Once setup is complete, automated compilation can be initiated with a single-line run command. Logik relies on the [Logiklib](https://github.com/siliconcompiler/logiklib) project for all architecture and device descriptions.
-We recommend using the SiliconCompiler `sc-install` utility to automatically install the correct versions of all open source FPGA tool dependencies.
+We recommend using the SiliconCompiler `sc-install` utility to automatically install the correct versions of all open-source FPGA tool dependencies.
-The Logik project is licensed under the open source [Apache License 2.0](LICENSE). For licensing terms of all dependencies, visit dependency repository.
+The Logik project is licensed under the open-source [Apache License 2.0](LICENSE). For licensing terms of all dependencies, visit each dependency repository.

Also applies to: 110-110, 121-121

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 8, Update the first paragraph that begins "Logik is an
open source FPGA tool chain..." to use standard hyphenation and a clearer
dependency/license clause: change "open source" to "open-source", "tool chain"
to "toolchain", "high level" to "high-level", and "single line run command" to
"single-line run command"; then reword the final sentence referencing Logiklib
(originally "Logik relies on the Logiklib project for all architecture and
device descriptions.") to something like "Logik relies on the Logiklib project
for architecture and device descriptions; see Logiklib for dependency licensing
and details." Ensure the edits are applied to the same sentence occurrences
targeted by the review (also present later at the other noted locations).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Line 78: Replace the generic link text "[here]" in the README sentence "The
required files can be found
[here](https://github.com/siliconcompiler/logik/tree/main/examples/adder)" with
a descriptive label such as "adder example files" or "examples/adder on GitHub"
so the link reads e.g. "The required files can be found in the adder example
files (link)"; update the link text only—keep the URL unchanged.

---

Nitpick comments:
In `@README.md`:
- Line 8: Update the first paragraph that begins "Logik is an open source FPGA
tool chain..." to use standard hyphenation and a clearer dependency/license
clause: change "open source" to "open-source", "tool chain" to "toolchain",
"high level" to "high-level", and "single line run command" to "single-line run
command"; then reword the final sentence referencing Logiklib (originally "Logik
relies on the Logiklib project for all architecture and device descriptions.")
to something like "Logik relies on the Logiklib project for architecture and
device descriptions; see Logiklib for dependency licensing and details." Ensure
the edits are applied to the same sentence occurrences targeted by the review
(also present later at the other noted locations).

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c94698ff-d38e-4e28-a319-c788c36c07f9

📥 Commits

Reviewing files that changed from the base of the PR and between 69e8201 and 43ea052.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md
@gigeresk gigeresk merged commit ef5fb79 into main Mar 22, 2026
7 checks passed
@gigeresk gigeresk deleted the readme_cosmetic branch March 22, 2026 16:05
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