Architecture Decision Record

Active theme: Light

← ਦਸਤਾਵੇਜ

ਚੰਗੇ ADR ਲਿਖਣ ਲਈ ਸੁਝਾਅ

ਚੰਗੇ ADR ਦੀਆਂ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ:

  • ਤਰਕ-ਆਧਾਰ: ਕਿਸੇ ਖਾਸ AD ਨੂੰ ਅਪਣਾਉਣ ਦੇ ਕਾਰਨ ਦੱਸੋ। ਇਸ ਵਿੱਚ ਪ੍ਰਸੰਗ (ਹੇਠਾਂ ਵੇਖੋ), ਵੱਖ-ਵੱਖ ਸੰਭਾਵੀ ਚੋਣਾਂ ਦੇ ਫਾਇਦੇ ਅਤੇ ਨੁਕਸਾਨ, ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਦੀ ਤੁਲਨਾ, ਲਾਗਤ/ਲਾਭ ਦੀ ਚਰਚਾ ਅਤੇ ਹੋਰ ਬਹੁਤ ਕੁਝ ਸ਼ਾਮਲ ਹੋ ਸਕਦਾ ਹੈ।

  • ਖਾਸ: ਹਰ ADR ਇੱਕ AD ਬਾਰੇ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ, ਕਈ AD ਬਾਰੇ ਨਹੀਂ।

  • ਟਾਈਮਸਟੈਂਪ: ਪਛਾਣ ਕਰੋ ਕਿ ADR ਦੀ ਹਰ ਗੱਲ ਕਦੋਂ ਲਿਖੀ ਗਈ। ਇਹ ਖਾਸ ਤੌਰ ਉੱਤੇ ਉਨ੍ਹਾਂ ਪਹਿਲੂਆਂ ਲਈ ਮਹੱਤਵਪੂਰਨ ਹੈ ਜੋ ਸਮੇਂ ਨਾਲ ਬਦਲ ਸਕਦੇ ਹਨ, ਜਿਵੇਂ ਕਿ ਲਾਗਤਾਂ, ਸਮਾਂ-ਸਾਰਣੀਆਂ, ਸਕੇਲਿੰਗ ਅਤੇ ਇਸ ਤਰ੍ਹਾਂ ਦੀਆਂ ਹੋਰ ਚੀਜ਼ਾਂ।

  • ਅਟੱਲ: ADR ਵਿੱਚ ਮੌਜੂਦਾ ਜਾਣਕਾਰੀ ਨੂੰ ਨਾ ਬਦਲੋ। ਇਸ ਦੀ ਬਜਾਏ, ਨਵੀਂ ਜਾਣਕਾਰੀ ਜੋੜ ਕੇ ADR ਵਿੱਚ ਸੋਧ ਕਰੋ, ਜਾਂ ਨਵਾਂ ADR ਬਣਾ ਕੇ ਪੁਰਾਣੇ ਨੂੰ ਬਦਲ ਦਿਓ।

ADR ਵਿੱਚ ਚੰਗੇ "ਪ੍ਰਸੰਗ" ਭਾਗ ਦੀਆਂ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ:

  • ਆਪਣੀ ਸੰਸਥਾ ਦੀ ਸਥਿਤੀ ਅਤੇ ਕਾਰੋਬਾਰੀ ਤਰਜੀਹਾਂ ਦੱਸੋ।

  • ਆਪਣੀਆਂ ਟੀਮਾਂ ਦੀ ਸਮਾਜਿਕ ਬਣਤਰ ਅਤੇ ਹੁਨਰਾਂ ਦੀ ਬਣਤਰ ਉੱਤੇ ਆਧਾਰਿਤ ਤਰਕ ਅਤੇ ਵਿਚਾਰ ਸ਼ਾਮਲ ਕਰੋ।

  • ਸੰਬੰਧਿਤ ਫਾਇਦੇ ਅਤੇ ਨੁਕਸਾਨ ਸ਼ਾਮਲ ਕਰੋ, ਅਤੇ ਉਨ੍ਹਾਂ ਨੂੰ ਇਸ ਤਰ੍ਹਾਂ ਬਿਆਨ ਕਰੋ ਕਿ ਉਹ ਤੁਹਾਡੀਆਂ ਲੋੜਾਂ ਅਤੇ ਟੀਚਿਆਂ ਨਾਲ ਮੇਲ ਖਾਣ।

ADR ਵਿੱਚ ਚੰਗੇ "ਨਤੀਜੇ" ਭਾਗ ਦੀਆਂ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ:

  • ਦੱਸੋ ਕਿ ਫੈਸਲਾ ਲੈਣ ਤੋਂ ਬਾਅਦ ਕੀ ਹੁੰਦਾ ਹੈ। ਇਸ ਵਿੱਚ ਪ੍ਰਭਾਵ, ਨਤੀਜੇ, ਆਉਟਪੁੱਟ, ਅਗਲੇਰੀ ਕਾਰਵਾਈ ਅਤੇ ਹੋਰ ਬਹੁਤ ਕੁਝ ਸ਼ਾਮਲ ਹੋ ਸਕਦਾ ਹੈ।

  • ਬਾਅਦ ਦੇ ਕਿਸੇ ਵੀ ADR ਬਾਰੇ ਜਾਣਕਾਰੀ ਸ਼ਾਮਲ ਕਰੋ। ਇਹ ਕਾਫ਼ੀ ਆਮ ਹੈ ਕਿ ਇੱਕ ADR ਹੋਰ ADR ਦੀ ਲੋੜ ਪੈਦਾ ਕਰ ਦਿੰਦਾ ਹੈ, ਜਿਵੇਂ ਕਿ ਜਦੋਂ ਇੱਕ ADR ਕੋਈ ਵੱਡੀ ਸਮੁੱਚੀ ਚੋਣ ਕਰਦਾ ਹੈ, ਜੋ ਅੱਗੇ ਹੋਰ ਛੋਟੇ ਫੈਸਲਿਆਂ ਦੀ ਲੋੜ ਪੈਦਾ ਕਰਦੀ ਹੈ।

  • ਕੋਈ ਵੀ ਕਾਰਵਾਈ ਤੋਂ ਬਾਅਦ ਦੀ ਸਮੀਖਿਆ ਪ੍ਰਕਿਰਿਆ ਸ਼ਾਮਲ ਕਰੋ। ਟੀਮਾਂ ਲਈ ਹਰ ADR ਦੀ ਇੱਕ ਮਹੀਨੇ ਬਾਅਦ ਸਮੀਖਿਆ ਕਰਨਾ ਆਮ ਗੱਲ ਹੈ, ਤਾਂ ਜੋ ADR ਦੀ ਜਾਣਕਾਰੀ ਦੀ ਅਸਲ ਅਭਿਆਸ ਵਿੱਚ ਜੋ ਹੋਇਆ ਉਸ ਨਾਲ ਤੁਲਨਾ ਕਰਕੇ ਸਿੱਖਿਆ ਅਤੇ ਤਰੱਕੀ ਕੀਤੀ ਜਾ ਸਕੇ।

ਨਵਾਂ ADR ਪਿਛਲੇ ADR ਦੀ ਥਾਂ ਲੈ ਸਕਦਾ ਹੈ:

  • ਜਦੋਂ ਕੋਈ AD ਲਿਆ ਜਾਂਦਾ ਹੈ ਜੋ ਪਿਛਲੇ ADR ਨੂੰ ਬਦਲਦਾ ਜਾਂ ਅਯੋਗ ਕਰਦਾ ਹੈ, ਤਾਂ ਇੱਕ ਨਵਾਂ ADR ਬਣਾਇਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ