Skip to content

Commit 4270fa5

Browse files
authored
Improve support navigation and direct users to CUPS Q&A (#242)
1 parent 66a1985 commit 4270fa5

7 files changed

Lines changed: 58 additions & 32 deletions

File tree

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
blank_issues_enabled: true
2+
contact_links:
3+
- name: Get help with printing
4+
url: https://github.com/OpenPrinting/cups/discussions/categories/q-a
5+
about: Ask printer setup, troubleshooting, and CUPS questions in OpenPrinting's community Q&A.

‎.github/SUPPORT.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Getting help
2+
3+
Ask printing questions in [OpenPrinting's Q&A forum](https://github.com/OpenPrinting/cups/discussions/categories/q-a).
4+
See [Contact Us](https://openprinting.github.io/contact) for what to include and other community contacts.
5+
6+
Use [this repository's issues](https://github.com/OpenPrinting/openprinting.github.io/issues)
7+
to report website bugs or incorrect content.

‎README.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,11 @@ The official website for [OpenPrinting](https://openprinting.github.io/), built
44

55
OpenPrinting is a Linux Foundation workgroup that manages the printing architecture for Linux and UNIX-like operating systems.
66

7+
## Need help with printing?
8+
9+
Ask in [OpenPrinting's Q&A forum](https://github.com/OpenPrinting/cups/discussions/categories/q-a).
10+
See the [support guide](.github/SUPPORT.md) for more details.
11+
712
## Getting Started
813

914
You need [Node.js](https://nodejs.org/) and [Yarn](https://yarnpkg.com/). Note that the

‎app/contact/page.tsx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ export default async function ContactPage() {
2222
<>
2323
<PageHero
2424
title={title}
25-
description="Get in touch with the OpenPrinting community"
25+
description="Get help with printing and connect with the OpenPrinting community"
2626
/>
2727

2828
<main className="min-h-screen bg-background text-foreground pt-24 pb-16">

‎components/navbar.tsx‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -131,8 +131,8 @@ export default function Navbar() {
131131
size="sm"
132132
className="bg-foreground text-background hover:bg-foreground/90 text-xs font-medium h-8 px-4 rounded-full transition-all duration-200"
133133
>
134-
<Link href={siteConfig.destinations.github} target="_blank" rel="noopener noreferrer">
135-
GitHub
134+
<Link href={siteConfig.destinations.support}>
135+
Get Help
136136
</Link>
137137
</Button>
138138
</motion.div>
@@ -251,8 +251,8 @@ export default function Navbar() {
251251
className="w-full bg-foreground text-background hover:bg-foreground/90 text-xs font-medium rounded-full"
252252
onClick={() => setIsOpen(false)}
253253
>
254-
<Link href={siteConfig.destinations.github} target="_blank" rel="noopener noreferrer">
255-
GitHub
254+
<Link href={siteConfig.destinations.support}>
255+
Get Help
256256
</Link>
257257
</Button>
258258
</motion.div>

‎config/site.config.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,7 @@ export interface SiteConfig {
3434
};
3535
destinations: {
3636
github: string;
37+
support: string;
3738
cups: string;
3839
drivers: string;
3940
legacyPrinters: string;
@@ -69,6 +70,7 @@ const canonicalOrigin =
6970
// override is honored; set NEXT_PUBLIC_BASE_PATH only for project-subpath previews.
7071
const basePath = process.env.NEXT_PUBLIC_BASE_PATH ?? "";
7172
const assetPrefix = basePath ? `${basePath}/` : "";
73+
const supportUrl = "https://github.com/OpenPrinting/cups/discussions/categories/q-a";
7274

7375
export const siteConfig: SiteConfig = {
7476
repo: {
@@ -97,6 +99,7 @@ export const siteConfig: SiteConfig = {
9799
},
98100
destinations: {
99101
github: "https://github.com/OpenPrinting",
102+
support: supportUrl,
100103
cups: "https://openprinting.github.io/cups/",
101104
drivers: "https://openprinting.org/drivers",
102105
legacyPrinters: "https://openprinting.org/printers",
@@ -138,6 +141,7 @@ export const siteConfig: SiteConfig = {
138141
{
139142
title: "Community",
140143
links: [
144+
{ name: "Get Help", href: supportUrl },
141145
{ name: "GitHub", href: "https://github.com/OpenPrinting" },
142146
{ name: "Google Summer of Code", href: "/gsoc" },
143147
{ name: "Google Season of Docs", href: "/gsod" },

‎contents/pages/contact.md‎

Lines changed: 32 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,41 @@
11
---
22
title: "Contact Us"
3-
permalink: /contact/
3+
permalink: /contact
44
layout: collection
55
header:
66
overlay_color: "#000"
77
overlay_filter: "0.5"
88
overlay_image: /assets/images/contact_us.jpeg
9-
excerpt: "Feel Free To Contact Us!"
9+
excerpt: "Get help with printing through OpenPrinting's community Q&A."
1010
author_profile: false
1111
---
12-
<p>
13-
<strong>Important:</strong> We protect the e-mail addresses of our mentors and mailing lists against spam bots. Please replace all occurrences of “ at ” and “ dot ” by “@” and “.” resp.
14-
</p>
15-
<div>
16-
<h1>Mailing Lists:</h1>
17-
<p>
18-
The lists were moved to the mail server <a href="https://subspace.kernel.org/lists.linux.dev.html">list.linux.dev</a>.
19-
<ul>
20-
<li><a href="https://lore.kernel.org/printing-architecture/" title="https://lore.kernel.org/printing-architecture/" rel="nofollow">Architecture</a></li>
21-
<li><a href="https://lore.kernel.org/printing-users/" title="https://lore.kernel.org/printing-users/" rel="nofollow">Users</a></li>
22-
</ul>
23-
</p>
24-
<p>
25-
<h1>Telegram</h1>
26-
<ul>
27-
<li><a href="https://t.me/+RizBbjXz4uU2ZWM1" title="Join our Telegram chat.">OpenPrinting chat</a></li>
28-
</ul>
29-
</p>
30-
<h1>GitHub</h1>
31-
<p>
32-
<ul>
33-
<li><a href="https://github.com/OpenPrinting" title="https://github.com/OpenPrinting" rel="nofollow">OpenPrinting GitHub</a></li>
34-
</ul>
35-
</p>
36-
</div>
12+
13+
## Get help with printing
14+
15+
Ask about printer setup, printing problems, or CUPS in
16+
**[OpenPrinting's Q&A forum](https://github.com/OpenPrinting/cups/discussions/categories/q-a)**.
17+
18+
Search for an existing answer first. To ask a question, sign in to GitHub and
19+
start a discussion in **Q&A**. Include:
20+
21+
- Printer model and connection type (USB, Wi-Fi, or Ethernet).
22+
- Operating system and version, plus your CUPS version if known.
23+
- What went wrong, any error messages, and what you have already tried.
24+
25+
Remove personal information and passwords from logs or screenshots before posting.
26+
27+
## Reporting a bug
28+
29+
Report confirmed bugs in the affected project's tracker, such as
30+
[CUPS issues](https://github.com/OpenPrinting/cups/issues).
31+
For broken links or incorrect website content, use
32+
[website issues](https://github.com/OpenPrinting/openprinting.github.io/issues).
33+
34+
## Community and development contacts
35+
36+
For mailing list subscriptions, see [lists.linux.dev](https://subspace.kernel.org/lists.linux.dev.html).
37+
38+
- [Printing architecture archives](https://lore.kernel.org/printing-architecture/) — development discussions.
39+
- [Printing users archives](https://lore.kernel.org/printing-users/) — past user discussions.
40+
- [Telegram chat](https://t.me/+RizBbjXz4uU2ZWM1) — informal community conversation.
41+
- [GitHub repositories](https://github.com/OpenPrinting) — source code and contributions.

0 commit comments

Comments
 (0)