Skip to content

Commit 3ea1fc4

Browse files
authored
Merge branch 'master' into enhancement/6444-kanvas-page-popup
2 parents 326ea72 + 35141e7 commit 3ea1fc4

File tree

1,176 files changed

+29670
-38359
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,176 files changed

+29670
-38359
lines changed

.github/ISSUE_TEMPLATE/news.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,22 @@
11
---
22
name: 📰 Layer5 News Update
3-
about: News items to be listed on https://layer5.io/news
3+
about: News about Layer5 and it's projects to be reprinted on https://layer5.io/news
44
title: '[News]'
55
labels: 'area/news, help wanted, framework/gatsby, language/markdown, good first issue'
66
assignees: ''
77
---
8-
We're in the news! Using the contributing instructions for [adding news](https://github.com/layer5io/layer5/blob/master/CONTRIBUTING.md#adding-news), please add the following article to the [Layer5 Newsroom](https://layer5.io/news).
8+
#### Description
9+
We're in the news! When this happens, we take a moment to reprint that news in our [newsroom](https://layer5.io/news).
10+
11+
#### Task
12+
1. Create a copy of the [news template](https://github.com/layer5io/layer5/tree/master/src/collections/news/news-template/0000-00-00-news-title).
13+
1. Follow the instructions included in the news template and rename the new file after the title of the news article using lowercase, kebab casing.
14+
1. Understand that this is a reprint request and that you are to copy/paste the published article verbatim. Be sure that you have included the filled in each of the front matter of properties. And have provided a hero image from the original article as well as that you use the original article authors name.
15+
1. Please add the following article to [src/collections/news](https://github.com/layer5io/layer5/tree/master/src/collections/news):
916

1017
**Article:**
11-
- Title:
12-
- Link:
18+
- Title:
19+
- Link:
1320

1421
---
1522
<img src="https://raw.githubusercontent.com/layer5io/layer5/master/.github/assets/images/layer5/5-light-small.svg" width="24px" align="left" /><h2>Contributor Resources and <a href="https://layer5.io/community/handbook">Handbook</a></h2>

.github/agents/QUICK_REFERENCE.md

Lines changed: 246 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,246 @@
1+
# blog-writer Agent Quick Reference
2+
3+
A quick reference card for using the blog-writer custom agent.
4+
5+
**Agent Configuration:**
6+
- Uses most powerful AI model available
7+
- Content tailored for platform engineers, DevOps engineers, SREs, IT administrators, Kubernetes operators, cloud native developers, solution architects, enterprise architects, and developers
8+
9+
## Basic Syntax
10+
11+
```
12+
@blog-writer [Create/Write] a blog post about [topic]
13+
```
14+
15+
## Common Tags (by usage frequency)
16+
17+
| Tag | Uses | Tag | Uses |
18+
|-----|------|-----|------|
19+
| Open Source | 18 | Meshery | 15 |
20+
| Community | 14 | Kubernetes | 9 |
21+
| ai | 8 | Meet The Maintainer | 8 |
22+
| docker | 7 | Service Mesh | 2+ |
23+
24+
## Common Categories
25+
26+
- **Meshery** - Meshery product features
27+
- **Community** - Community news, events, spotlights
28+
- **Open Source** - Open source topics
29+
- **Kubernetes** - K8s-focused content
30+
- **Kanvas** - Kanvas features and guides
31+
- **Platform Engineering** - Platform engineering topics
32+
- **Cloud Native** - General cloud native content
33+
34+
## Required Components Checklist
35+
36+
- [ ] Frontmatter with all fields
37+
- [ ] BlogWrapper import and usage
38+
- [ ] At least 1 graphic/image
39+
- [ ] At least 1 CTA component
40+
- [ ] BlockQuote or BlockQuoteAlt
41+
- [ ] Multiple cross-page links
42+
- [ ] SEO-optimized title & description
43+
44+
## Component Quick Reference
45+
46+
### Imports
47+
```jsx
48+
import { BlogWrapper } from "../../Blog.style.js";
49+
import { Link } from "gatsby";
50+
import Blockquote from "../../../../reusecore/Blockquote";
51+
import BlockquoteAlt from "../../../../reusecore/Blockquote/Blockquote-alt-style";
52+
import CTA_FullWidth from "../../../../components/Call-To-Actions/CTA_FullWidth";
53+
```
54+
55+
### BlockQuote
56+
```jsx
57+
<Blockquote
58+
quote="Your impactful quote"
59+
person="Name"
60+
title="Title/Role"
61+
/>
62+
```
63+
64+
### CTA
65+
```jsx
66+
<CTA_FullWidth
67+
image={CTAImg}
68+
heading="Heading"
69+
alt="Alt text"
70+
content="Description"
71+
button_text="Button Text"
72+
url="/path"
73+
external_link={false}
74+
/>
75+
```
76+
77+
### Images
78+
```jsx
79+
// Import
80+
import myImage from "./my-image.png";
81+
82+
// Use
83+
<img src={myImage} className="image-center" alt="Alt text" />
84+
```
85+
86+
### Links
87+
```jsx
88+
<Link to="/cloud-native-management/meshery">Meshery</Link>
89+
```
90+
91+
### Special Divs
92+
```jsx
93+
<div class="intro">
94+
<p>Introductory text</p>
95+
</div>
96+
97+
<div class="note">
98+
<a href="url">Call to action</a>
99+
</div>
100+
101+
<div class="tip">
102+
<h3>Tip Title</h3>
103+
<p>Tip content</p>
104+
</div>
105+
```
106+
107+
## CSS Classes for Images
108+
109+
| Class | Effect |
110+
|-------|--------|
111+
| `image-left` | Float left with shadow |
112+
| `image-right` | Float right with shadow |
113+
| `image-left-no-shadow` | Float left, no shadow |
114+
| `image-right-no-shadow` | Float right, no shadow |
115+
| `image-center` | Center, full width |
116+
| `image-center-shadow` | Center with shadow |
117+
118+
## Common Link Destinations
119+
120+
| Type | Path |
121+
|------|------|
122+
| Meshery | `/cloud-native-management/meshery` |
123+
| Kanvas | `/cloud-native-management/meshery/design` |
124+
| Catalog | `/cloud-native-management/catalog` |
125+
| Community | `/community` |
126+
| Slack | `https://slack.layer5.io` |
127+
| Blog | `/blog` |
128+
| Resources | `/resources` |
129+
130+
## SEO Guidelines
131+
132+
- **Title**: 50-60 characters, keyword at start
133+
- **Description**: 150-160 characters, includes keywords
134+
- **URL**: Descriptive, under 60 chars, use hyphens
135+
- **H2/H3**: Include keywords naturally
136+
137+
## File Structure
138+
139+
```
140+
/src/collections/blog/YYYY/MM-DD-descriptive-slug/
141+
├── post.mdx (or index.mdx)
142+
├── image1.png
143+
├── image2.png
144+
└── ...
145+
```
146+
147+
## Frontmatter Template
148+
149+
```yaml
150+
---
151+
title: "Title Here"
152+
subtitle: "Subtitle here"
153+
date: YYYY-MM-DD HH:MM:SS -0530
154+
author: Layer5 Team
155+
thumbnail: ./image.png
156+
darkthumbnail: ./image.png
157+
description: "Meta description here"
158+
type: Blog
159+
category: Category Name
160+
tags:
161+
- Tag1
162+
- Tag2
163+
featured: false
164+
published: true
165+
resource: true
166+
product: Meshery
167+
---
168+
```
169+
170+
**Note:** Always use "Layer5 Team" as the default author.
171+
172+
## RSS Feed Rules
173+
174+
| Feed | Criteria |
175+
|------|----------|
176+
| Meshery Community | Category: Meshery/Announcements/Events AND tags: Community/Meshery/mesheryctl |
177+
| Main Blog | All posts |
178+
| Technical Posts | Exclude: Programs/Community/Events/FAQ |
179+
| News | All news items |
180+
181+
## Quick Prompts
182+
183+
### Feature Post
184+
```
185+
@blog-writer Feature announcement for [Product] - [Feature].
186+
Include use case, how-to, CTA.
187+
```
188+
189+
### Tutorial
190+
```
191+
@blog-writer Step-by-step tutorial: [Topic].
192+
Mark as resource. Include troubleshooting.
193+
```
194+
195+
### Community
196+
```
197+
@blog-writer Community post about [Event/Person].
198+
Use Community category and BlockQuote.
199+
```
200+
201+
### Technical
202+
```
203+
@blog-writer Technical deep-dive: [Topic].
204+
Include code examples, diagrams, best practices.
205+
```
206+
207+
## What Agent Handles
208+
209+
✅ Frontmatter structure
210+
✅ Component imports
211+
✅ Tag/category selection
212+
✅ SEO optimization
213+
✅ Required elements
214+
✅ Cross-linking
215+
✅ RSS feed consideration
216+
217+
## What You Review
218+
219+
📝 Technical accuracy
220+
📝 Tag relevance
221+
📝 Image descriptions
222+
📝 CTA destinations
223+
📝 Link validity
224+
📝 Overall tone
225+
226+
## Troubleshooting
227+
228+
| Problem | Solution |
229+
|---------|----------|
230+
| Wrong category | Specify in prompt: "use [Category] category" |
231+
| Missing component | Request explicitly: "include BlockQuote and CTA" |
232+
| Too technical | Add: "target audience: beginners/general" |
233+
| Not technical enough | Add: "target audience: engineers/architects" |
234+
| Need specific tags | List in prompt: "use tags: X, Y, Z" |
235+
236+
## Resources
237+
238+
- Full docs: `.github/agents/README.md`
239+
- Examples: `.github/agents/USAGE_EXAMPLES.md`
240+
- Template: `/src/collections/blog/blog-template/index.mdx`
241+
- Contributing: `CONTRIBUTING.md`
242+
- Style guide: `AGENTS.md`
243+
244+
---
245+
246+
**Pro Tip**: Start with a simple prompt, review the output, then refine with more specific requirements in a follow-up prompt.

0 commit comments

Comments
 (0)