Skip to content

Link to Walter, Andrei Action List #4435

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
burner wants to merge 4 commits into from
Closed

Link to Walter, Andrei Action List #4435

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b4c2161
Link to Walter, Andrei Action List
burner Jun 18, 2016
286b6d2
more informative
burner Jun 19, 2016
b51deab
David feedback
burner Jun 19, 2016
95e0c64
Readd contributing.md hint
burner Jun 19, 2016
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 29 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
![D Logo](http://dlang.org/images/dlogo.png) Phobos Standard Library
===================================================================
====================================================================


Phobos is the standard library that comes with the
[D Programming Language](http://dlang.org) Compiler.
Expand All @@ -11,7 +12,7 @@ Phobos is the standard library that comes with the
* [Wiki](http://wiki.dlang.org/)

Download
--------
========

Phobos is packaged together with the compiler.
You should
Expand All @@ -24,8 +25,31 @@ Phobos is distributed under Boost Software Licence.
See the [licence file](LICENSE_1_0.txt).

I Want to Contribute
--------------------
====================

New packages in Phobos
-------------------------

Phobos is the standard library of the D programming language and thus tries to standardize APIs to ease development for many other programmers.
Hence it's great if you want to contribute and make Phobos even better, but there are some important points that you should pay attention too.

### Blocking points for additions

In general there are some indications why something fits better to dub than to the standard library:

- Low applicability / potential usage (e.g. QR Code generation, Tribune client)
- Many valid ways to do something (e.g. UI framework, web server API)
- Fast moving targets (e.g. CSS library, Game engine)
Copy link
Contributor

@JackStouffer JackStouffer Jul 14, 2016 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would add

  • thin D wrappers around popular APIs (e.g. imagemagick, libpng)


The bottom line is that if you want to write an amazing library that touches one of those fields, go ahead!
With dub potential users can easily use your library and if it proves to be very popular, it might even find it's way to Phobos ;-)

### Finding good points to contribute

If you want to help improving Phobos, a good starting point to find meaningful tasks is the [issue tracker](https://issues.dlang.org/buglist.cgi?component=phobos&list_id=209027&product=D&resolution=---).
Furthermore the [D Wishlist](https://wiki.dlang.org/Wish_list) contains more abstract, high-level goals.

Great!
See the [CONTRIBUTING.md file](CONTRIBUTING.md).
If you want to write new modules for Phobos, we highly encourage you to stay in touch with the community early on.
Apart from receiving vital feedback and avoiding duplicate efforts, the approval of the community is needed for new additions. In particular, be sure to keep in touch with Andrei Alexandrescu, who manages Phobos and can **veto** new additions.

For more information see [CONTRIBUTING.md file](CONTRIBUTING.md).