diff --git a/docs/other-resources.md b/docs/other-resources.md
index 6bb49d8..1c2be6f 100644
--- a/docs/other-resources.md
+++ b/docs/other-resources.md
@@ -41,14 +41,14 @@ This more of a feature than a defect in RSCSS: it forces you to create new compo
 ```
 
 ```css
-/* rscss: ✗ confusing impractical */
+/* RSCSS: ✗ confusing and impractical */
 .site-search {
   > .top > .info > .label > .icon { /*...*/ }
 }
 ```
 
 ```css
-/* rscss: ✓ better to create sub-components */
+/* RSCSS: ✓ better to create sub-components for deep hierarchies */
 .site-search-label {
   > .icon { /*...*/ }
 }