This is a common enough question on Discord that we should probably make
it easier for people to find the answer themselves (or at least have an
easy thing to refer people to when it inevitably arises anyway).

Signed-off-by: Zev Weiss <zev@bewilderbeest.net>
Change-Id: I54757f0902bfedca86d41cab0fc55b39cb7dfc1e

Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: Ia4bd10225cf9a0c96869fb826f39800c801af03e

The representative from Meta (Facebook) has been updated.

Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: Ia7ea79a2a543d5fbba1f8aa2394761e14f83b74a

A few URLs in the README file pointed to the old openpower.xyz Jenkins
server.  That domain no longer exists and appears to have been bought
by a parking service.  Replace them with URLs to the openbmc.org Jenkins
server and point to corresponding jobs (which have different names).

Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: I8341f390a154172972f8c3b40228fe20706d7ac7

A fork of it is maintained but its upstream layer has largely been
unmaintained.
No future products are planned to be based on this layer.
Mihawk is similar to Witherspoon.

Signed-off-by: Myung Bae <myungbae@us.ibm.com>
Change-Id: I82f7d777b78cd126237d51e42f1e11abdf80ae68

This is the current list, minus the qemu machines.

Change-Id: I6f1a5b1dddb27471ce0d550a4acb4c5e3dc3f738
Signed-off-by: Joel Stanley <joel@jms.id.au>

Remove the distro version so we don't need to keep it up to date, and
refresh the dependency list. The deps are sufficient to do a build in a
container.

Change-Id: Ieabac79846ac9f70676a920e868c2542159105b9
Signed-off-by: Joel Stanley <joel@jms.id.au>

Issue #3798 pointed out perl-FindBin is required on Fedora 34 to
configure and build openssl.

Change-Id: I0966fc7992cbc192eef5b156546565ea90c73cab
Signed-off-by: Milton Miller <miltonm@us.ibm.com>

Roxanne will be IBM's new representative on the TSC for OpenBMC

Signed-off-by: Andrew Geissler <geissonator@yahoo.com>
Change-Id: Ic4747a63778537564a28357ff7f38d5d87ce6beb

I am no longer on the TSC, so removing myself.

Signed-off-by: Brad Bishop <bradleyb@fuzziesquirrel.com>
Change-Id: Ia6c31b17a2eaae37453886d3b648e42997f8eafc

Add Ubuntu packages ztd and pigz

Signed-off-by: Daniel Anderson <daniel.anderson@intel.com>
Change-Id: I2659eee34f833a5c67d1e0c7484076c35994b45e

Replaced Intel TSC representative James Mihm with Terry Duncan.

Signed-off-by: James Mihm <James.Mihm@Intel.com>
Change-Id: Ibe8195021ff3f4e1f787ad41eb51db2eeae6f43c

Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: I3daacc34af1b628f2f1e279a45e1e13bf06ac746

Update information about all the possible target machines.
Remove extra information about 'evb-ast2500' target as it no longer
needs a special handling.

Signed-off-by: Konstantin Aladyshev <aladyshev22@gmail.com>
Change-Id: Id05bb976cc339d62bcf6433251bd8b0f8787ccbd

Replace Supreeth Venkatesh with Samer El-Haj-Mahmound who represents
Arm now.

Signed-off-by: Gilbert Chen <gilbert.chen@arm.com>
Change-Id: I3f0cfb8a130cf77228a0bf6d5b904526ef832e01

Stop specifying the build directory in the example so people don't trip
over the incomprehensible errors that occur when they eventually do
change platform.

Change-Id: Id67d74169cac69be99aca5ecb3d4eeac37dcef44
Signed-off-by: Andrew Jeffery <andrew@aj.id.au>

"can be described as" sounds a lot like Chris Austen having a chat with
someone over a beer. To the extent that Yocto is a Linux distribution
(which it isn't, but that's somewhat of a detail), OpenBMC is also a
distribution.

Change-Id: I5e72c3b357441a41c525b843bc1768d5946b645b
Signed-off-by: Andrew Jeffery <andrew@aj.id.au>

The witherspoon-128 machine was removed with openbmc/openbmc commit
40c2946. Remove it from the README and re-arrange the machine names
alphabetically so it's easier to find and maintain the names.

Change-Id: I02a88bc85167b42622c2c3db8e4e3b43db4444e2
Signed-off-by: Adriana Kobylak <anoo@us.ibm.com>

Replace rainier with p10bmc as build target. Keep the rainier.conf as a
symlink to p10bmc.conf to allow the transition. Remove the rainier.conf
and the machine override from p10bmc.conf in a later commit to complete
the replacement.

Tested: Built rainier and p10bmc and checked for some files/service
        units to exist on both.

Change-Id: Ic8c8c6ffbc3507fbd9c692da259e37ae695359a6
Signed-off-by: Adriana Kobylak <anoo@us.ibm.com>

Discord has more users. IRC traffic has ground to a halt.

No real objection to
https://lists.ozlabs.org/pipermail/openbmc/2020-November/023984.html



Removed IRC and Riot from the README and replaced IRC in other places.

Change-Id: I7124b11320f6c31e9e0a2aead35274690ff0f908
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: I7af13404d6e5101ac3d9d05d5f7d1c1d4e550d9d

Add invite link to Discord per announcement email at
https://lore.kernel.org/openbmc/20201112145740.GB4495@heinlein/



Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: Iedde67dc94d071206688bece588ac2615bbb9f01

The usage of setup script in README is missing the arguments, add them
so it is more clear how the script is called.

Before the script, the default build directory is `build`, so update the
example of romulus build to specify the `build` directory.

Otherwise, each machine has its own build directory. They do not share
the downloads dir or the sstate dir.

Signed-off-by: Lei YU <yulei.sh@bytedance.com>
Change-Id: I21fcb1a133941fbbff80a33a250ece687622477b

The evb-ast2500 config by `. setup` command was broken due to duplicated
machine config. Add a special note about how to manually specify the
machine config to setup the build.

Signed-off-by: Lei YU <yulei.sh@bytedance.com>
Change-Id: Ifad02bef1c8c5246494adcc3a8a4b6aaa974633b

Remove the reference to openpower.xyz, as we've shifted domains.

Change-Id: I2c14852691e1afec2ab88ae960a6ae623a3bdc0e
Signed-off-by: Andrew Jeffery <andrew@aj.id.au>

The `setup` script is there for quite a while but is still
not described in the README.md, so the documentation teaches
the users how to set up the environment the hard way.

This commit makes it easier for the newcomers to set up
the build environment.

Change-Id: I1901273246567ff2c211edb251f65106263daf6f
Signed-off-by: Alexander Amelkin <a.amelkin@yadro.com>

2b90a9f2 missed a name on the TSC list.
This commit fixes that mistake.

The TSC list is moving to the openbmc/openbmc README because the docs
README is becoming specific to the docs repo and the openbmc/openbmc
README is for more general project information since the openbmc/openbmc
README is most likely the first landing spot of anyone new to
the project.

Change-Id: I8884df9e7abc05d4551fe745dfb729c7b7dad0d8
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

This commit adds the TSC (Technical Steering Committee) info
to the openbmc/openbmc README.

As suggested in and partially implemented in
https://gerrit.openbmc-project.xyz/c/openbmc/docs/+/28107

 the docs
README is specific to the docs repo and the openbmc/openbmc README
is for more general project information since the openbmc/openbmc
README is most likely the first landing spot of anyone new to
the project.

Change-Id: I539357bd78dbad39bda874b68a4acb587ecb5595
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

User management and Virtual media are done.

Change-Id: Ided3ed088cbcfadf9c9d94af5667977ebbb27246
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

Clarify that users should not open issues for questions.

There has been a fair amount of issues opened for general questions,
this aims to cut back on that.

Change-Id: I1048ca9c1ff801789ae7c61ecd8caed4103e4eb3
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

Change-Id: Iad7c66387dc12bdae68b0ccf221cad7db5ff20d9
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>

Romulus is what OpenBMC uses for its CI environment so is where new
users should be pointed at when first trying it out

Change-Id: I1de412cef5915b955bd0c874a396b2b59e8fcf57
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>

Getting lots of questions for a variety of topics in a variety of
locations. Clarify where users should look and post their questions.

Change-Id: I06f497e23f50abab4130effb883dc3d91935d21f
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>

Resolves openbmc/openbmc#3404

Change-Id: Iaf59bbe6bcc3c30a6e90ebd706780c7c28873c9c
Signed-off-by: Andrew Jeffery <andrew@aj.id.au>

This updates the list of OpenBMC features and links to the feature
TOC in the docs repository.

Tested: via copy/paste into: https://dillinger.io



Change-Id: I3c9fdbb0fb87b3524550ee95ae7e37f623885bed
Signed-off-by: Joseph Reynolds <jrey@us.ibm.com>

The On-Chip Controller is a Power-specific item while the rest of the
list generalises over multiple host architectures.

Change-Id: I56e0b5c65615aa416391a29630b5d0a8d56960ec
Signed-off-by: Andrew Jeffery <andrew@aj.id.au>

Recent documents use Romulus as the example platform for
getting developers up to speed on developing for OpenBMC:

https://github.com/openbmc/docs/tree/master/development



Romulus was used because it's used by CI for every job,
therefore being the most stable and supported.

Change-Id: Icaac937696305f6c9131b2063954cc523b6d2df5
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>

Change-Id: Iaa29eb3e523548dd746c366f318a67e14e3683f7
Signed-off-by: Stewart Smith <stewart@linux.ibm.com>

The new subtree model brings the subtrees up from the openbmc-machines
layer.

Change-Id: I58a03ae1be374bc79ae1438e65e888375d12d0c0
Signed-off-by: Dave Cobbley <david.j.cobbley@linux.intel.com>
Signed-off-by: Brad Bishop <bradleyb@fuzziesquirrel.com>

According to the official Charter at
https://www.openbmc.org/wp-content/uploads/sites/62/2018/03/charter_openbmc_02142018.pdf
the file must be named literally `CONTRIBUTING`.
That is, all caps.

This has been discussed in review comments for
https://gerrit.openbmc-project.xyz/9948

This commit accompanies the corresponding changes to
the docs repository, see
https://gerrit.openbmc-project.xyz/c/openbmc/docs/+/10807



Change-Id: I320b9a4b18d4e4a741cbcb29fff8475994493ae6
Signed-off-by: Alexander Amelkin <a.amelkin@yadro.com>