Skip to content

Commit 259b217

Browse files
PeterTurcanalandefreitas
authored andcommitted
Landing pages for Community sections added
1 parent 8f50b50 commit 259b217

File tree

4 files changed

+68
-0
lines changed

4 files changed

+68
-0
lines changed

contributor-guide/modules/ROOT/nav.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,5 +61,6 @@ Official repository: https://github.com/boostorg/website-v2-docs
6161
** xref:release-notes.adoc[]
6262
6363
* Community
64+
** xref:contributor-community-introduction.adoc[]
6465
** xref:tweeting.adoc[]
6566
** xref:site-docs-style-guide.adoc[]
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
////
2+
Copyright (c) 2024 The C++ Alliance, Inc. (https://cppalliance.org)
3+
4+
Distributed under the Boost Software License, Version 1.0. (See accompanying
5+
file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
6+
7+
Official repository: https://github.com/boostorg/website-v2-docs
8+
////
9+
= Introduction to the Contributor Community
10+
:navtitle: Introduction
11+
12+
The Boost Contributors Community is a dedicated group of developers and enthusiasts committed to advancing the Boost libraries. There are many different ways of xref:getting-involved.adoc[] with this community.
13+
14+
== Communications
15+
16+
The https://lists.boost.org/mailman/listinfo.cgi/boost[Boost Developers Mailing List] is focused on the development and maintenance of the libraries. It is a platform for proposing new libraries, discussing design and implementation details, and coordinating efforts among contributors. Participation in these mailing lists is open to all. In addition to mailing lists, the Boost community also leverages https://slack.com/[Slack] for real-time communication. The Slack Workspace hosts various channels dedicated to specific libraries, general discussions, and coordination among contributors.
17+
18+
When discussing Boost-related topics on social media, contributors are encouraged to follow our xref:tweeting.adoc[Tweeting] guidelines. These guidelines help ensure that the community maintains a positive and informative presence on social media.
19+
20+
New library developers usually have a lot of questions on their mind, before asking for help or information refer to the xref:contributors-faq.adoc[] for answers to many common questions and dilemmas.
21+
22+
== Documentation Style
23+
24+
A consistent documentation style, that emphasizes readability and accessibility, is encouraged. This includes all the library xref:docs/documentation-guidelines.adoc[Documentation Guidelines] and contributions to this website (refer to xref:site-docs-style-guide.adoc[]).
25+
26+
== See Also
27+
28+
* xref:user-guide:ROOT:user-community-introduction.adoc[]

user-guide/modules/ROOT/nav.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,7 @@ Official repository: https://github.com/boostorg/website-v2-docs
3535
** xref:implementation-variations.adoc[]
3636
3737
* Community
38+
** xref:user-community-introduction.adoc[]
3839
** xref:reporting-issues.adoc[]
3940
** xref:discussion-policy.adoc[]
4041
** xref:bsl.adoc[]
Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
////
2+
Copyright (c) 2024 The C++ Alliance, Inc. (https://cppalliance.org)
3+
4+
Distributed under the Boost Software License, Version 1.0. (See accompanying
5+
file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
6+
7+
Official repository: https://github.com/boostorg/website-v2-docs
8+
////
9+
= Introduction to the User Community
10+
:navtitle: Introduction
11+
12+
The user community is a vibrant and collaborative group dedicated to the use, development, and maintenance of Boost Libraries. Since its inception, Boost has grown to offer a wide range of libraries that address knarly programming tasks, from algorithms and data structures to system utilities and concurrent programming. Boost users are encouraged to chime in with their thoughts and experiences!
13+
14+
== Reporting Issues
15+
16+
Users are encouraged to be active in xref:reporting-issues.adoc[] they encounter with Boost libraries. Users can submit issues directly, providing detailed descriptions, code snippets, and steps to reproduce the problem. This collaboration greatly aids the overall stability and reliability of Boost libraries.
17+
18+
== Boost Mailing Lists
19+
20+
Communication within the Boost community is primarily conducted through mailing lists. The https://lists.boost.org/mailman/listinfo.cgi/boost-users[Boost Users Mailing List] is a forum to ask questions, share experiences, and seeking advice. Participation in the mailing lists is open to all.
21+
22+
=== Discussion Policy
23+
24+
Boost maintains a clear and respectful xref:discussion-policy.adoc[Discussion Policy] to ensure productive and courteous interactions within the community. Participants are expected to engage in constructive dialogue, refrain from personal attacks, and respect differing viewpoints.
25+
26+
== Boost Software License
27+
28+
The xref:bsl.adoc[Boost Software License (BSL)] is a free, open-source license that permits users to use, modify, and distribute Boost libraries with minimal restrictions. The BSL is designed to be compatible with both open-source and proprietary projects.
29+
30+
== Long History
31+
32+
Boost's long xref:boost-history.adoc[History] is a testament to its enduring relevance and impact. Since its founding in 1998 by the late xref:in-memoriam-beman-dawes.adoc[Beman Dawes], David Abrahams, and Robert Klarer, Boost has been an incubator for cutting-edge pass:[C++] techniques and practices.
33+
34+
Over the years, Boost has grown to include dozens of libraries, each developed and maintained by dedicated contributors from around the world. The libraries are continually updated both to remedy issues and add new features, refer to xref:release-process.adoc[] for the process and cadence of new releases.
35+
36+
== See Also
37+
38+
* xref:contributor-guide:ROOT:contributor-community-introduction.adoc[]

0 commit comments

Comments
 (0)