Apply suggestions from code review Co-Authored-By: Jin <jin@users.noreply.github.com>

diff --git a/docs/skydoc_deprecation.md b/docs/skydoc_deprecation.md
index d86fc90..87b7236 100644
--- a/docs/skydoc_deprecation.md
+++ b/docs/skydoc_deprecation.md

@@ -22,7 +22,7 @@
 Stardoc uses inline documentation strings instead of Python-style docstrings.
 For example, Skydoc documentation may have been specified with:
 
-```
+```python
 my_rule = rule(
     implementation = _my_rule_impl,
     attrs = {

diff --git a/docs/writing_stardoc.md b/docs/writing_stardoc.md
index 6c1c2b4..ce10ebd 100644
--- a/docs/writing_stardoc.md
+++ b/docs/writing_stardoc.md

@@ -11,8 +11,8 @@
 inline documentation as well as evaluates the Starlark code to determine the
 types for rule attributes. Stardoc will, by default, generate documentation for
 all rules, macros, and functions reachable from a target `.bzl` file.
-(See [Generating Stardoc][generating_stardoc.md] for details on limiting the
-symbols for which stardoc generates documentation.)
+See [Generating Stardoc][generating_stardoc.md] for details on limiting the
+symbols for which stardoc generates documentation.
 
 <a name="rule-documentation"></a>
 ## Rule Documentation

diff --git a/setup.bzl b/setup.bzl
index 2e63b65..5c8c119 100644
--- a/setup.bzl
+++ b/setup.bzl

@@ -21,7 +21,7 @@
         repo_rule(name = name, **kwargs)
 
 def stardoc_repositories():
-    """Adds the external repositories used by the starlark rules."""
+    """Adds the external repositories used by the Starlark rules."""
     _include_if_not_defined(
         http_archive,
         name = "bazel_skylib",