xref: /aosp_15_r20/external/flashrom/doc/contact.rst (revision 0d6140be3aa665ecc836e8907834fcd3e3b018fc)
1Contact
2========
3.. The extra = is needed to prevent git from throwing a `leftover conflict marker`
4   error when commiting.
5
6.. _mailing list:
7
8Mailing List
9------------
10Flashrom related mails are welcome on the flashrom mailing list at `[email protected] <mailto:[email protected]>`_.
11Please do NOT send any BIOS images or F segment dumps to the list!
12
13E-mails with binary files attached will be rejected. Images for things such as scope or logic analyzer traces are acceptable
14if hosted on a third-party photo sharing service that assigns a unique URL to the image, such as Google Photos.
15This prevents the photo URL from being abused for malicious or inappropriate content.
16
17Please note that the list is moderated for non-subscribers and we recommend to subscribe first.
18
19Subscription
20""""""""""""
21https://mail.coreboot.org/postorius/lists/flashrom.flashrom.org/
22
23Archives
24""""""""
25| https://mail.coreboot.org/hyperkitty/list/[email protected]/
26| https://mail.coreboot.org/pipermail/flashrom/ (Up to Dec. 2018)
27| https://marc.info/?l=flashrom
28| https://www.mail-archive.com/[email protected]/
29
30Moderation rules
31""""""""""""""""
32If your mail is too big (the current limit is 256 kB) or if you're not on the subscriber list, your mail will be held for moderation.
33If your mail contains any BIOS images or F segment dumps (instead of links which are fine), the mail will be rejected for legal reasons
34(we do not have the right to distribute BIOS images).
35
36.. _real time channels:
37
38Real time channels
39------------------
40
41Flashrom has real time channels where you have the chance to talk to people being involved or interested in the project.
42Most of the discussion is about flashrom development, contributions, tech talk and user help.
43
44You are welcome to join and discuss current and future flashrom development, ideas and contributions.
45
46If you have a problem and would like to get help, don't ask for help. Instead, just explain your problem right away,
47and make sure to describe the situation as much as possible, so that other people can understand you and provide meaningful answers.
48Otherwise, others have to ask or guess the details of your problem, which is frustrating for both parties.
49
50Should you need to paste lots of text (more than three lines), please use a `paste service <https://en.wikipedia.org/wiki/Pastebin>`_.
51For flashrom logs, feel free to use `paste.flashrom.org <https://paste.flashrom.org>`_.
52Other good paste services are `ix.io <http://ix.io/>`_, `paste.rs <https://paste.rs/>`_, `bpaste.net <https://bpaste.net/>`_,
53`gist.github.com <https://gist.github.com/>`_  and `dpaste.com <http://dpaste.com/>`_.
54
55Questions on `coreboot <https://coreboot.org>`_, `OpenBIOS <http://www.openbios.info/>`_, firmware and related topics are welcome in **#coreboot** on the same server.
56
57Discord
58"""""""
59
60Flashrom Discord channel is hosted on coreboot's server. Once you join, you will be able to see all coreboot's and flashrom's channels in one place.
61To join, use the `invite link <https://discord.gg/dgcrkwVyeR>`_.
62
63IRC
64"""
65
66You can join `#flashrom <irc://irc.libera.chat/#flashrom>`_
67channel on the `Libera.chat <https://www.libera.chat/>`_ `IRC <https://en.wikipedia.org/wiki/Internet_Relay_Chat>`_ network.
68If you don't have an IRC client, you can use the Libera.chat `webchat <https://web.libera.chat/#flashrom>`_.
69
70**#flashrom** channel is bridged to `Matrix <https://matrix.org/>`_.
71If you would like to join, you can use `this invite link <https://matrix.to/#/#flashrom:libera.chat>`_.
72
73Do note that IRC's nature has a significant effect on conversations. People from all over the world can join this channel
74with many different cultures and timezones. Most people are in the `CET timezone <https://en.wikipedia.org/wiki/Central_European_Time>`_,
75so the channel may be very quiet during `CET nighttime <https://time.is/CET>`_.
76
77If you receive no replies, *please be patient*.
78After all, silence is better than getting replied with `"IDK" <https://en.wiktionary.org/wiki/IDK>`_.
79Frequently, somebody knows the answer, but hasn't checked IRC yet. In any case, please *do not leave the channel while waiting for an answer!*
80Since IRC does not store messages, replying to somebody who left the channel is *impossible*.
81
82To have persistence on IRC, you can set up an `IRC bouncer <https://en.wikipedia.org/wiki/Internet_Relay_Chat#Bouncer>`_
83like `ZNC <https://en.wikipedia.org/wiki/ZNC>`_, or use `IRCCloud <https://www.irccloud.com/>`_.
84Please **do not publish any logs** of this channel.
85
86Most of the time, people use IRC on wider-than-tall screens. Because of this, consider that pressing the return key is expensive.
87Instead of sending lots of tiny messages with only about two words, prefer using longer sentences, spaces and punctuation symbols.
88If reading and understanding your messages is easy, replying to them is also easy.
89
90*Note: the channel is not moderated or monitored by any of the current active maintainers.*
91
92Dev meeting
93-----------
94Flashrom developers community runs an online meeting every two weeks.
95The main purpose of the meeting is to discuss development plans, ideas,
96current ongoing projects, pending patches, and sometimes organisational questions.
97
98Note this meeting is NOT:
99
100* troubleshooting session
101* tech support forum
102* user training session
103
104For questions above, please use IRC or the mailing list.
105
106Time of meeting
107"""""""""""""""
108It runs once every two weeks.
109
110**IMPORTANT**: please calculate meeting time for your local timezone.
111
112Between November and March (inclusive)
113
114    **Wednesday 21:00-22:00 UTC+0**
115
116    also known as
117
118    | Wednesday 13:00-14:00 Pacific Standard Time UTC-8
119    | Wednesday 22:00-23:00 Central European Time UTC+1
120    | Thursday 8:00-9:00 Australian Eastern Daylight Time UTC+11
121
122Between April and September (inclusive)
123
124    **Thursday 6:00-7:00 UTC+0**
125
126    also known as
127
128    | Wednesday 23:00-midnight Pacific Daylight Time UTC-7
129    | Thursday 8:00-9:00 Central European Summer Time UTC+2
130    | Thursday 16:00-17:00 Australian Eastern Standard Time UTC+10
131
132The last week of March and 4 weeks of October there are no meetings
133This is because daylight saving time changes are happening on different dates in different locations, and setting up meeting time becomes too complicated.
134
135FAQ
136"""
137**When is the next meeting?**
138
139Look into the meeting notes `document <https://docs.google.com/document/d/18qKvEbfPszjsJJGJhwi8kRVDUG3GZkADzQSH6WFsKqw/edit?usp=sharing>`_.
140The top entry, on the first page, with the date in the future, and empty list of attendees - is the next meeting.
141
142
143**How to join the meeting?**
144
145In the meeting notes `document <https://docs.google.com/document/d/18qKvEbfPszjsJJGJhwi8kRVDUG3GZkADzQSH6WFsKqw/edit?usp=sharing>`_,
146on the top it says “to join, click the link”, click the link.
147
148
149**Do I need an invitation to join the meeting?**
150
151No, just join.
152
153
154**Do I need to create an account anywhere?**
155
156No, you can join without an account, and view/comment on the meeting doc without an account.
157
158
159**How do I add a topic to the agenda?**
160
161Add comments/suggestions on the meeting doc, and they will be accepted shortly after.
162