Skip to content

Commit

Permalink
Grammar check, sentence tweaks, and typo fixes. Covers all pages of t…
Browse files Browse the repository at this point in the history
…he academy.
  • Loading branch information
cryptoguard committed Sep 28, 2021
1 parent eec6d0e commit 45fb85a
Show file tree
Hide file tree
Showing 29 changed files with 315 additions and 341 deletions.
24 changes: 1 addition & 23 deletions faq/common_issues_general.rst.txt
Original file line number Diff line number Diff line change
@@ -1,27 +1,5 @@
**General Support Questions**

.. container:: toggle

.. container:: header

**Time offset warning icon (top right corner of Particl Desktop)**

This warning simply means your computer is synced to a different time than the Particl network. Usually, this doesn't cause any noticeable issue, but when the offset gets too big, it can cause errors in the propagation of :term:`SecureMessaging (SMSG)` messages (listings, escrow, etc).

.. tabs::
.. group-tab:: Windows

#. Download timesync tool
#. etc

.. group-tab:: Mac

#. ?

.. group-tab:: Linux

#. ?

.. container:: toggle

.. container:: header
Expand All @@ -31,7 +9,7 @@
- Make sure you are using |PD version|.
- Make sure you haven't made any **typo** in any of the 24 words.
- Enter your seed's password, if you have any.
- Try only entering your 24-word passphrase, **without** any password.
- Try only entering your 24-word passphrase **without** any password.
- If all else fails, do a hard reset of Particl.

.. container:: toggle
Expand Down
23 changes: 11 additions & 12 deletions faq/common_issues_mp.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@
**No listing is showing up on the marketplace (empty marketplace)**

- Make sure you are using |PD version|.
- Check if in the top right corner the :guilabel:`peers` icon is a red circle. If it's the case check your firewall settings. The :term:`Particl Desktop` client is not able to contact the network. Make sure your internet connection is available at all.
- Check if in the top right corner the :guilabel:`peers` icon is a red circle. If it's the case, check your firewall settings. The :term:`Particl Desktop` client is not able to contact the network. Make sure your internet connection is available at all.
- Leave :term:`Particl Desktop` open for a few minutes so that it can sync the blockchain and load the market data. This can take several minutes and tends to take longer on slow internet connections.
- Reset your market database by first making a copy of your ``particl-market`` folder and then deleting it (**don't delete the backup copy**). Keep in mind this is a last resort solution. It will permanently remove all your market-related data such as current orders, listings, order history, and etc. **Make sure that you do not have any active order before doing this step or you will permanently lose access to the escrow contracts.**
- Reset your market database by first making a copy of your ``particl-market`` folder and then deleting it (**don't delete the backup copy**). Keep in mind this is a last resort solution. It will permanently remove all your market-related data such as current orders, listings, order history, and etc. **Make sure that you do not have any active order before doing this step, or you will permanently lose access to the escrow contracts.**

.. tabs::
.. group-tab:: Windows
Expand Down Expand Up @@ -45,7 +45,7 @@
**I can't publish a listing**

- Make sure you are using |PD version|.
- Make sure you have enough PART in your public or private balance to cover for the listing fees.
- Make sure you have enough PART in your public or private balance to cover the listing fees.


.. container:: toggle
Expand All @@ -63,20 +63,20 @@

**The escrow process is jammed. Neither the buyer or seller can progress further**

In rare occasions, the :term:`SecureMessaging (SMSG)` network can encounter message propagation issues. This can lead to issues such as the escrow system not progressing further even when both transacting parties complete the escrow steps. To fix that issue, you can manually resend messages to the other party.
On rare occasions, the :term:`SecureMessaging (SMSG)` network can encounter message propagation issues. This can lead to issues such as the escrow system not progressing further even when both transacting parties complete the escrow steps. To fix that issue, you can manually resend messages to the other party.

.. tabs::
.. group-tab:: As the seller

#. Find the order you want to fix in the ``Orders`` tab of the ``SELL`` page.
#. Note down the order's ID.
#. Open the Debug console window by clicking on its icon at the top right corner of your :term:`Particl Desktop` client.
#. Click on the ``Market`` tab and enter the following command by replacing ``<ID>`` by the order ID you've just noted down.
#. Click on the ``Market`` tab and enter the following command by replacing ``<ID>`` with the order ID you've just noted down.
``orderitem history <id>``
#. This will give you a lot of data about the order. Copy everything and paste it into text document to better search for the data you need to continue further.
#. This will give you a lot of data about the order. Copy everything and paste it into a text document to better search for the data you need to continue further.
#. Note down the ``<msgid>`` values you need for the next step.
- If your buyer has successfully locked its funds in escrow but you're not getting that notification and can't progress further, then you need to note down 2 ``msgid`` values: **MPA_COMPLETE** and **MPA_SHIP**.
- If you've sent the item to your buyer but he hasn't received that notification and can't confirm that he has received the item, then you only need to note down the **MPA_SHIP** ``<msgid>`` value.
- If your buyer has successfully locked its funds in escrow, but you're not getting that notification and can't progress further, then you need to note down two ``msgid`` values: **MPA_COMPLETE** and **MPA_SHIP**.
- If you've sent the item to your buyer, but he hasn't received that notification and can't confirm that he has received the item, then you only need to note down the **MPA_SHIP** ``<msgid>`` value.
#. Run the following command(s) in :term:`Particl Desktop`'s Debug window for each ``<msgid>`` value you've noted down (**MPA_COMPLETE** first, then **MPA_SHIP**).
``smsg resent <msgid>``

Expand All @@ -85,12 +85,11 @@
#. Find the order you want to fix in the ``Orders`` tab of the ``PURCHASE`` page.
#. Note down the order's ID.
#. Open the Debug console window by clicking on its icon at the top right corner of your :term:`Particl Desktop` client.
#. Click on the ``Market`` tab and enter the following command by replacing ``<ID>`` by the order ID you've just noted down.
#. Click on the ``Market`` tab and enter the following command by replacing ``<ID>`` with the order ID you've just noted down.
``orderitem history <id>``
#. This will give you a lot of data about the order. Copy everything and paste it into text document to better search for the data you need to continue further.
#. This will give you a lot of data about the order. Copy everything and paste it into a text document to better search for the data you need to continue further.
#. Note down the ``<msgid>`` values you need for the next step.
- If you have successfully locked your funds (payment + security deposit) in escrow but the seller isn't getting that notification and can't progress further, then you need to note down the ``msgid`` value of **MPA_LOCK**.
- If you've received the item but can't confirm the order as completed, then contact the seller and ask them to complete resend **MPA_SHIP** (instructions located in the *As the seller* tab of this page) value.
- If you have successfully locked your funds (payment + security deposit) in escrow, but the seller isn't getting that notification and can't progress further, then you need to note down the ``msgid`` value of **MPA_LOCK**.
#. Run the following command in :term:`Particl Desktop`'s Debug window by replacing ``<msgid>`` with the value of **MPA_LOCK**.
``smsg resent <msgid>``

6 changes: 3 additions & 3 deletions faq/faq_coin_staking.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@

**Why are some of my coins aren't staking after receiving my last staking reward?**

When staking, your coins are separated in outputs. Each output stakes separately with the hopes of finding and verifying a block.
When staking, your coins are separated into multiple outputs. Each output stakes separately with the hopes of finding and verifying a block.

When one of your output stakes a block, or when you receive a transaction, the output is temporarily made unavailable until it can be moved or stake blocks again. This process is referred to as "maturing" and lasts for a period of 225 blocks (~8 hours).
When one of your outputs stakes a block, or when you receive a transaction, the output is temporarily unavailable until it can be moved or stake blocks again. This process is referred to as "maturing" and lasts for 225 blocks (~8 hours).

Once your output is mature once again, you'll be able to transact the coins it contains and it'll be able to stake blocks once gain.
Once your output is mature once again, you'll be able to transact the coins it contains, and it'll be able to stake blocks once again.
4 changes: 2 additions & 2 deletions faq/faq_mp_customers_overview.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,10 @@

**What does each order status mean?**

- :guilabel:`BIDDING`: You have made a bid on an item and are now waiting for the vendor to accept it.
- :guilabel:`ORDER REQUEST`: You have requested an order on an item and are now waiting for the vendor to accept it.
- :guilabel:`ACCEPTED`: The vendor has accepted your order and is now waiting for you to send the payment and your security deposit in escrow.
- :guilabel:`ESCROW`: You have locked your funds in escrow and are now waiting for the vendor to lock their security deposit as well.
- :guilabel:`PACKAGING`: The vendor is now packaging your order and and getting it ready to ship.
- :guilabel:`PACKAGING`: The vendor is now packaging your order and getting it ready to ship.
- :guilabel:`SHIPPING`: The vendor has shipped your item and is now waiting for you to receive and confirm the delivery.
- :guilabel:`COMPLETE`: You have received your order and have confirmed the order as "complete". There are no more required actions in this transaction, and you've received your security deposit back.

Expand Down
2 changes: 1 addition & 1 deletion faq/faq_mp_general_overview.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Frequently Asked Questions

The Particl Academy is up-to-date with Particl's latest version, |PD version|.

Got any question not answered here? Then **let us know** about it so that we can help you out and update the Particl Academy!
Got any questions not answered here? Then **let us know** about it so that we can help you out and update the Particl Academy!

Particl Coin Questions
----------------------
Expand Down
4 changes: 2 additions & 2 deletions faq/get_support.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Get Support
===========

Do you have any question not answered anywhere on the Particl Academy? Then let us know about it so that we can help you out and update the Particl Academy!
Do you have any questions not answered anywhere on the Particl Academy? Then let us know about it so that we can help you out and update the Particl Academy!

To seek out for help, join Particl's **Help channel** on `Discord <https://discord.me/particl>`_ or `Telegram <https://t.me/particlhelp>`_ where the Particl community and team will be able to assist you. You can also get help by posting on the `community forum <https://particl.community>`_.
To seek out help, join Particl's **Help channel** on `Discord <https://discord.me/particl>`_ or `Telegram <https://t.me/particlhelp>`_, where the Particl community and team will assist you. You can also get help by posting on the `community forum <https://particl.community>`_.

0 comments on commit 45fb85a

Please sign in to comment.