Skip to content

Commit 93aab01

Browse files
committed
style
1 parent 6475981 commit 93aab01

File tree

3 files changed

+107
-72
lines changed

3 files changed

+107
-72
lines changed

.github/workflows/jekyll-gh-pages.yml

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,11 +30,15 @@ jobs:
3030
id: changes
3131
run: |
3232
git fetch origin main --depth=2
33-
CHANGED=$(git diff --name-only HEAD~1 HEAD 2>/dev/null || echo "")
34-
# Release if any changes outside github-pages/ and .github/
35-
if echo "$CHANGED" | grep -qvE '^(github-pages/|\.github/)'; then
33+
# Get files changed, excluding github-pages/ and .github/
34+
CONTENT_CHANGES=$(git diff --name-only HEAD~1 HEAD 2>/dev/null | grep -vE '^(github-pages/|\.github/|$)' || true)
35+
# Release only if there are content changes
36+
if [ -n "$CONTENT_CHANGES" ]; then
37+
echo "Content changes detected:"
38+
echo "$CONTENT_CHANGES"
3639
echo "release=true" >> $GITHUB_OUTPUT
3740
else
41+
echo "No content changes, skipping release"
3842
echo "release=false" >> $GITHUB_OUTPUT
3943
fi
4044

TUTORIAL.md

Lines changed: 29 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -150,52 +150,60 @@ Best for:
150150

151151
## FAQ
152152

153-
<details>
153+
<details class="faq-item">
154154
<summary>Does MCAF work with any programming language?</summary>
155-
156-
Yes. MCAF is language-agnostic. Define your `build`, `test`, `format` commands for your stack.
155+
<div class="faq-answer">
156+
Yes. MCAF is language-agnostic. Define your <code>build</code>, <code>test</code>, <code>format</code> commands for your stack.
157+
</div>
157158
</details>
158159

159-
<details>
160+
<details class="faq-item">
160161
<summary>Do I need all documentation folders?</summary>
161-
162-
Start with `Features/`, `ADR/`, and `Development/`. Add others as needed.
162+
<div class="faq-answer">
163+
Start with <code>Features/</code>, <code>ADR/</code>, and <code>Development/</code>. Add others as needed.
164+
</div>
163165
</details>
164166

165-
<details>
167+
<details class="faq-item">
166168
<summary>What if my team doesn't have a dedicated QA?</summary>
167-
169+
<div class="faq-answer">
168170
Developers take the QA perspective. The point is ensuring test coverage, not having a specific role.
171+
</div>
169172
</details>
170173

171-
<details>
174+
<details class="faq-item">
172175
<summary>Why avoid mocking internal services?</summary>
173-
176+
<div class="faq-answer">
174177
Mocks hide integration bugs. Real containers catch issues that mocks miss.
178+
</div>
175179
</details>
176180

177-
<details>
181+
<details class="faq-item">
178182
<summary>How much test coverage is enough?</summary>
179-
183+
<div class="faq-answer">
180184
Every significant behaviour needs at least one integration/API/UI test. Focus on workflows, not percentages.
185+
</div>
181186
</details>
182187

183-
<details>
188+
<details class="faq-item">
184189
<summary>Which AI agents work with MCAF?</summary>
185-
186-
Any AI coding assistant that can read files. Point them to `AGENTS.md`.
190+
<div class="faq-answer">
191+
Any AI coding assistant that can read files. Point them to <code>AGENTS.md</code>.
192+
</div>
187193
</details>
188194

189-
<details>
195+
<details class="faq-item">
190196
<summary>How does the agent learn my preferences?</summary>
191-
192-
Update `AGENTS.md` when you give feedback. Chat is not memory — the file is.
197+
<div class="faq-answer">
198+
Update <code>AGENTS.md</code> when you give feedback. Chat is not memory — the file is.
199+
</div>
193200
</details>
194201

195-
<details>
202+
<details class="faq-item">
196203
<summary>Can I adopt MCAF gradually?</summary>
197-
198-
Yes. Start with `AGENTS.md` and one feature doc. Add structure as you go.
204+
<div class="faq-answer">
205+
Yes. Start with <code>AGENTS.md</code> and one feature doc. Add structure as you go.
206+
</div>
199207
</details>
200208

201209
---

github-pages/assets/css/style.css

Lines changed: 71 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -735,80 +735,103 @@ body.dark .reading-time {
735735
color: #888;
736736
}
737737

738-
/* Details/Summary (collapsible sections) */
739-
details {
740-
background: #FFFFFF;
741-
border: 1px solid #E8E5EB;
742-
border-radius: 12px;
743-
margin-bottom: 16px;
744-
box-shadow: 0 2px 8px rgba(39, 35, 42, 0.06);
738+
/* Details/Summary (collapsible FAQ sections) */
739+
details.faq-item {
740+
background: #FFFFFF !important;
741+
border: 1px solid #E8E5EB !important;
742+
border-radius: 12px !important;
743+
margin-bottom: 16px !important;
744+
box-shadow: 0 2px 8px rgba(39, 35, 42, 0.06) !important;
745+
overflow: hidden !important;
745746
}
746747

747-
details[open] {
748-
border-color: #785D8F;
748+
details.faq-item[open] {
749+
border-color: #785D8F !important;
750+
box-shadow: 0 4px 12px rgba(120, 93, 143, 0.15) !important;
749751
}
750752

751-
summary {
752-
padding: 16px 20px;
753-
cursor: pointer;
754-
font-weight: 600;
755-
font-size: 16px;
756-
color: #27232A;
757-
list-style: none;
758-
display: block;
753+
details.faq-item summary {
754+
padding: 18px 24px !important;
755+
cursor: pointer !important;
756+
font-weight: 600 !important;
757+
font-size: 16px !important;
758+
color: #27232A !important;
759+
list-style: none !important;
760+
display: block !important;
761+
background: #FAFAFA !important;
762+
margin: 0 !important;
759763
}
760764

761-
summary::-webkit-details-marker {
762-
display: none;
765+
details.faq-item summary::-webkit-details-marker {
766+
display: none !important;
763767
}
764768

765-
summary::marker {
766-
display: none;
769+
details.faq-item summary::marker {
770+
display: none !important;
771+
content: "" !important;
767772
}
768773

769-
summary:hover {
770-
background: #F5F3F7;
771-
border-radius: 12px;
774+
details.faq-item summary:hover {
775+
background: #F0EDF3 !important;
772776
}
773777

774-
details[open] > summary {
775-
color: #785D8F;
776-
border-bottom: 1px solid #E8E5EB;
777-
border-radius: 12px 12px 0 0;
778+
details.faq-item[open] > summary {
779+
color: #785D8F !important;
780+
background: #F5F3F7 !important;
781+
border-bottom: 1px solid #E8E5EB !important;
778782
}
779783

780-
details > p {
781-
padding: 16px 20px;
782-
margin: 0;
783-
color: #4a4a4a;
784-
line-height: 1.7;
784+
details.faq-item .faq-answer {
785+
padding: 20px 24px !important;
786+
margin: 0 !important;
787+
color: #4a4a4a !important;
788+
line-height: 1.8 !important;
789+
background: #FFFFFF !important;
790+
font-size: 15px !important;
785791
}
786792

787-
/* Dark mode details */
788-
body.dark details {
789-
background: #1a1a1a;
790-
border-color: #333;
793+
details.faq-item .faq-answer code {
794+
background: #F5F3F7 !important;
795+
padding: 2px 6px !important;
796+
border-radius: 4px !important;
797+
font-size: 14px !important;
791798
}
792799

793-
body.dark details[open] {
794-
border-color: #a88bc4;
800+
/* Dark mode FAQ */
801+
body.dark details.faq-item {
802+
background: #1a1a1a !important;
803+
border-color: #333 !important;
804+
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3) !important;
795805
}
796806

797-
body.dark summary {
798-
color: #e0e0e0;
807+
body.dark details.faq-item[open] {
808+
border-color: #a88bc4 !important;
809+
box-shadow: 0 4px 12px rgba(168, 139, 196, 0.2) !important;
799810
}
800811

801-
body.dark summary:hover {
802-
background: #2a2a2a;
812+
body.dark details.faq-item summary {
813+
color: #e0e0e0 !important;
814+
background: #222 !important;
803815
}
804816

805-
body.dark details[open] > summary {
806-
color: #a88bc4;
807-
border-bottom-color: #333;
817+
body.dark details.faq-item summary:hover {
818+
background: #2a2a2a !important;
808819
}
809820

810-
body.dark details > p {
811-
color: #b0b0b0;
821+
body.dark details.faq-item[open] > summary {
822+
color: #a88bc4 !important;
823+
background: #252525 !important;
824+
border-bottom-color: #333 !important;
825+
}
826+
827+
body.dark details.faq-item .faq-answer {
828+
color: #b0b0b0 !important;
829+
background: #1a1a1a !important;
830+
}
831+
832+
body.dark details.faq-item .faq-answer code {
833+
background: #2a2a2a !important;
834+
color: #a88bc4 !important;
812835
}
813836

814837
/* Print styles */

0 commit comments

Comments
 (0)