ਆਪਣੇ ਸਾਫਟਵੇਅਰ ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਲਈ ਵੈਬਸਾਈਟ ਕਿਵੇਂ ਬਣਾਉਣੀ

ਦਰਸ਼ਕ, ਦਾਇਰਾ ਅਤੇ ਸਫਲਤਾ ਮਾਪਦੰਡ ਤੈਅ ਕਰੋ

ਇੱਕ ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਵੈਬਸਾਈਟ ਤਦ ਹੀ ਲਾਭਦਾਇਕ ਹੁੰਦੀ ਹੈ ਜਦੋਂ ਇਹ ਲੋਕਾਂ ਨੂੰ ਤੇਜ਼ੀ ਨਾਲ ਬਿਹਤਰ ਫੈਸਲੇ ਲੈਣ ਵਿੱਚ ਮਦਦ ਕਰੇ। ਇੱਕ ਵੀ ਪੰਨਾ ਲਿਖਣ ਤੋਂ ਪਹਿਲਾਂ, ਲਕੜੀ ਦੀ ਭਾਸ਼ਾ ਵਿੱਚ ਲਕੜੀ ਦਾ ਲਕੜਾ ਤੈਅ ਕਰੋ: ਖਤਰਾ ਘਟਾਉਣਾ, ਟੀਮਾਂ ਨੂੰ ਲਾਈਨ ਕਰਨਾ, ਅਤੇ ਕਿਰਿਆਵਾਈ ਦੀ ਗਤੀ ਤੇਜ਼ ਕਰਨਾ। ਇਹ ਲਕੜਾ ਤੁਹਾਡੇ ਪ੍ਰਕਾਸ਼ਨ (ਅਤੇ ਜੋ ਤੁਸੀਂ ਛੱਡਦੇ ਹੋ) ਲਈ ਛਣਣੀ ਦਾ ਕੰਮ ਕਰੇਗਾ।

ਆਪਣੇ ਮੁੱਖ ਦਰਸ਼ਕਾਂ ਦੀ ਪਛਾਣ ਕਰੋ

ਜ਼ਿਆਦਾਤਰ ਮਾਈਗ੍ਰੇਸ਼ਨ ਪ੍ਰੋਜੈਕਟਾਂ ਦੇ ਕਈ ਪੜ੍ਹਨ ਵਾਲੇ ਹੁੰਦੇ ਹਨ ਜਿਨ੍ਹਾਂ ਦੇ ਸਵਾਲ ਅਤੇ ਵਕਤ ਬਜਟ ਵੱਖ-ਵੱਖ ਹੁੰਦੇ ਹਨ। ਉਨ੍ਹਾਂ ਨੂੰ ਖੁੱਲ੍ਹ ਕੇ ਨਾਮ ਦਿਓ ਤਾਂ ਜੋ ਤੁਹਾਡੀ ਸਮੱਗਰੀ ਜੇਹੀ ਨਾ ਲੱਗੇ:

• IT / ਇੰਜੀਨੀਅਰਜ਼: ਪੂਰਵ-ਸ਼ਰਤਾਂ, ਮਾਹੌਲ, ਇਕੀਕਰਨ ਵੇਰਵੇ, ਰੋਲਬੈਕ ਕਦਮ
• ਪ੍ਰੋਜੈਕਟ ਮੈਨੇਜਰਜ਼: ਮਾਈਲਸਟੋਨ, ਡਿਪੈਂਡੇੰਸੀਜ਼, RACI, ਸਥਿਤੀ ਸੰਕੇਤ
• ਐਂਡ ਯੂਜ਼ਰ / ਓਪਰੇਸ਼ਨਜ਼: ਕੀ ਬਦਲੇਗਾ, ਕੀ ਉਹੀ ਰਹੇਗਾ, ਟਰੇਨਿੰਗ ਅਤੇ ਸਹਾਇਤਾ
• ਐਗਜ਼ਿਕਿਊਟਿਵ / ਸਪਾਂਸਰਜ਼: ਪ੍ਰਭਾਵ, ਖਤਰਾ ਨਿਯੰਤਰਣ, ਰੈਡੀਨੈਸ, ਜਾ/ਨਹੀਂ-ਜਾਣ ਲਈ ਮਾਪਦੰਡ

ਜੇ ਤੁਸੀਂ ਹਰ ਦਰਸ਼ਕ ਦੇ ਸਿਖਰ ਦੇ 3 ਸਵਾਲ ਵਰਣਨ ਨਹੀਂ ਕਰ ਸਕਦੇ, ਤਾਂ сайт_generic ਮਹਿਸੂਸ ਹੋ ਸਕਦੀ ਹੈ।

ਦਾਇਰਾ (ਤੇ ਜੋ ਸਮੇਤ ਨਹੀਂ) ਤੈਅ ਕਰੋ

ਛੋਟਾ "ਇਹ ਸਾਈਟ ਕੀ ਕਵਰ ਕਰਦੀ ਹੈ" ਬਿਆਨ ਲਿਖੋ, ਫਿਰ ਮਿਲਦੇ-ਜੁਲਦੇ "ਇਹ ਸਾਈਟ ਕੀ ਨਹੀਂ ਕਵਰ ਕਰਦੀ" ਸ਼ਾਮِل ਕਰੋ। ਉਦਾਹਰਨ ਵਜੋਂ: ਸਾਈਟ ਸਮਰਥਿਤ ਪਾਥ, ਡੇਟਾ ਮੈਪਿੰਗ, ਅਤੇ ਵੈਰੀਫਿਕੇਸ਼ਨ ਕਵਰ ਕਰ ਸਕਦੀ ਹੈ, ਪਰ ਨਹੀਂ ਕਸਟਮ ਕਨਸਲਟਿੰਗ ਸਲਾਹ, ਤੀਜੀ-ਪੱਖ ਸਪਲਾਇਰ ਠੇਕੇ, ਜਾਂ ਹਰ ਐਜ ਕੇਸ।

ਇਸ ਨਾਲ ਮਦਦ ਮਿਲਦੀ ਹੈ ਕਿ ਗਾਈਡ ਭਰੋਸੇਯੋਗ ਰਹੇ ਅਤੇ ਬਣੇ-ਬਣਾਏ ਇੱਕ-ਆਫ ਐਡਿਸ਼ਨਾਂ ਨਾਲ ਭਰ ਨਾ ਜਾਵੇ।

"ਮੁੱਕ ਗਿਆ" ਕਿਹੜਾ ਹੈ, ਇਹ ਪਰਿਭਾਸ਼ਿਤ ਕਰੋ

ਸਫਲਤਾ ਕੇਵਲ ਪੰਨਾਂ ਦੀ ਗਿਣਤੀ ਨਹੀਂ ਹੋਣੀ ਚਾਹੀਦੀ। ਉਦਾਹਰਨਾਂ:

• ਕامیਾਬੀ ਕਟਓਵਰ ਨਿਯਤ ਵਿੰਡੋ ਵਿੱਚ ਪੂਰਾ ਹੋਣਾ
• ਅਪਣਾਉਣ: ਨਿਸ਼ਚਿਤ ਉਪਭੋਗੀ ਨਵੀਂ ਸਿਸਟਮ ਵਿੱਚ ਮੁੱਖ ਕੰਮ ਕਰ ਸਕਣ
• ਵੈਰੀਫਿਕੇਸ਼ਨ: ਡੇਟਾ ਚੈੱਕ ਅਤੇ ਐਕਸੈਪਟੈਂਸ ਟੈਸਟ ਪਾਸ ਹੋ ਜਾਣ

ਤਣਾਵ ਵਾਲੇ ਪਾਠਕਾਂ ਲਈ "ਇੱਥੋਂ ਸ਼ੁਰੂ ਕਰੋ" ਰਾਹ ਰੱਖੋ

ਇੱਕ ਇੱਕਲ ਐਂਟਰੀ ਪੇਜ਼ ਬਣਾਓ (ਉਦਾਹਰਨ: /start-here) ਜਿਸ 'ਤੇ ਰੁਖਣ ਲਈ ਘੱਟੋ-ਘੱਟ ਕਦਮ ਹੋਣ: ਇਹ ਗਾਈਡ ਕਿਸ ਲਈ ਹੈ, ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਮਾਈਗ੍ਰੇਸ਼ਨ ਪਾਥ, ਅਹੰਕਾਰਕ ਪੂਰਵ-ਸ਼ਰਤਾਂ, ਅਤੇ ਮਾਈਗ੍ਰੇਸ਼ਨ ਚੈੱਕਲਿਸਟ ਪੇਜ਼ ਕਿੱਥੇ ਮਿਲੇਗੀ। ਇਹ ਉਲਝਣ ਘਟਾਉਂਦਾ ਅਤੇ ਸ਼ੁਰੂ ਵਿੱਚ ਹੀ ਹਿੱਸੇਦਾਰਾਂ ਨੂੰ ਇਕ-ਲੇਬਲ 'ਤੇ ਲਿਆਉਂਦਾ।

ਗਾਈਡ ਲਈ ਜਾਣਕਾਰੀ ਆਰਕੀਟੈਕਚਰ (IA) ਯੋਜਨਾ ਬਣਾਓ

ਇੱਕ ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਉਸ ਵੇਲੇ ਸਫਲ ਹੁੰਦੀ ਹੈ ਜਦੋਂ ਪੜ੍ਹਨ ਵਾਲਾ ਸਹੀ ਨਿਰਦੇਸ਼ ਸੈਕਿੰਡਾਂ ਵਿੱਚ ਲੱਭ ਸਕੇ—ਖਾਸਕਰ ਜਦੋਂ ਸਮੇਤ ਦਬਾਅ ਹੋਵੇ। ਜਾਣਕਾਰੀ ਆਰਕੀਟੈਕਚਰ (IA) ਉਹ ਯੋਜਨਾ ਹੈ ਜੋ ਤੁਹਾਡੇ ਸਮੱਗਰੀ ਨੂੰ ਅਨੁਮਾਨਯੋਗ ਬਣਾਉਂਦੀ: ਇੱਕੋ ਕਿਸਮ ਦੇ ਪੰਨੇ ਹਮੇਸ਼ਾਂ ਇੱਕੋ ਥਾਂ ਰਹਿੰਦੇ ਹਨ, ਅਤੇ URL ਉਹ ਕੰਮ ਦੇ ਸੰਗਤ ਹੁੰਦੇ ਹਨ ਜੋ ਕੋਈ ਕਰਨ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰ ਰਿਹਾ ਹੈ।

ਇੱਕ ਸਧਾਰਨ ਟੌਪ-ਲੇਵਲ ਫਲੋ ਨਾਲ ਸ਼ੁਰੂ ਕਰੋ

ਜ਼ਿਆਦਾਤਰ ਸਾਫਟਵੇਅਰ ਮਾਈਗ੍ਰੇਸ਼ਨਾਂ ਲਈ, ਇੱਕ ਸਪਸ਼ਟ ਫੇਜ਼-ਅਧਾਰਤ ਢਾਂਚਾ ਸਭ ਤੋਂ ਵਧੀਆ ਕੰਮ ਕਰਦਾ ਹੈ:

• Plan → Prepare → Migrate → Validate → Operate

ਇਸ ਨਾਲ ਸਾਈਟ ਮਾਈਗ੍ਰੇਸ਼ਨਾਂ ਦੇ ਤਰੀਕੇ ਨਾਲ ਸੰਗਤ ਰਹਿੰਦੀ ਹੈ ਅਤੇ ਨਾਨ-ਟੈਕਨੀਕਲ ਪਾਠਕਾਂ ਨੂੰ ਸਮਝਣ ਵਿੱਚ ਆਸਾਨੀ ਹੁੰਦੀ ਹੈ ਕਿ ਉਹ ਯਾਤਰਾ ਵਿੱਚ ਕਿੱਥੇ ਹਨ।

ਜਿੱਥੇ ਦੁਹਰਾਏ ਜਾਣ ਵਾਲੇ ਸਾਮਾਨ ਰਹਿਣਗੇ, ਓਥੇ ਫੈਸਲਾ ਕਰੋ (ਅਤੇ ਉਹਨਾਂ ਨੂੰ ਕਦਮਾਂ ਵਿਚੋਂ ਰੱਖੋ)

ਚੈੱਕਲਿਸਟ, ਟੈਮਪਲੇਟ, ਅਤੇ FAQs ਕੀਮਤੀ ਹਨ—ਪਰ ਉਹ ਕਦਮ-ਦਰ-ਕਦਮ ਪੰਨਿਆਂ ਨੂੰ ਭਰ ਨਹੀਂ ਦੇਣੇ ਚਾਹੀਦੇ।

ਅਲੱਗ ਹਬ ਬਣਾਓ ਜੋ ਤੁਸੀਂ ਕਈ ਥਾਵਾਂ ਤੋਂ ਲਿੰਕ ਕਰ ਸਕੋ, ਉਦਾਹਰਨ:

• /guide/checklists/ ਲਈ “migration checklist page” ਸਮੱਗਰੀ (cutover, rollback, data verification)
• /guide/templates/ ਲਈ ਸਪ੍ਰੈਡਸ਼ੀਟਾਂ, ਈਮੇਲ ਡਰਾਫਟ, ਸਟੇਕਹੋਲਡਰ ਸੰਚਾਰ, ਮੀਟਿੰਗ ਏਜੰਡੇ
• /guide/faq/ ਲਈ ਦੁਹਰਾਏ ਸਵਾਲ ਅਤੇ ਐਜ ਕੇਸ

ਇਸ ਨਾਲ ਡੁਪਲੀਕੇਸ਼ਨ ਘਟਦਾ ਹੈ ਅਤੇ ਜਦੋਂ ਲੋੜ ਬਦਲੇ ਤਾਂ ਅਪਡੇਟ ਸੁਰੱਖਿਅਤ ਹੁੰਦੇ ਹਨ।

ਇੱਕ ਸੰਘਣੀ URL ਪੈਟਰਨ ਵਰਤੋ ਜੋ ਇਰਾਦੇ ਨਾਲ ਮਿਲਦੀ ਹੋਵੇ

ਸ਼ੁਰੂ ਵਿੱਚ ਹੀ ਇੱਕ URL ਸਕੀਮ ਚੁਣੋ ਅਤੇ ਉਸ ਨਾਲ ਟਿਕੇ ਰਹੋ। ਇੱਕ ਚੰਗਾ ਡਿਫ਼ਾਲਟ ਇਹ ਹੈ:

• /guide/<phase>/<topic>/
• ਉਦਾਹਰਨ: /guide/prepare/data-export/

ਲਗਾਤਾਰ URLs ਤੁਹਾਡੇ ਮਾਈਗ੍ਰੇਸ਼ਨ ਡੌਕਯੂਮੈਂਟੇਸ਼ਨ ਸਾਈਟ ਨੂੰ ਨੈਵੀਗੇਟ ਕਰਨਯੋਗ, ਖੋਜਯੋਗ ਅਤੇ ਮਸਤੂ ਰਹਿਤ ਬਣਾਉਂਦੇ ਹਨ।

“ਓਵਰਵਿਊ” ਤੇ “ਕਦਮ-ਦਰ-ਕਦਮ” ਪਾਠਕਾਂ ਲਈ ਅਲੱਗ ਰਾਹ ਯੋਜਨਾ ਕਰੋ

ਹਰ ਕੋਈ ਇੱਕੋ ਤਰੀਕੇ ਨਾਲ ਗਾਈਡ ਨਹੀਂ ਪੜ੍ਹਦਾ। ਹਿੱਸੇਦਾਰ ਅਕਸਰ ਨਤੀਜੇ, ਜੋਖਮ ਅਤੇ ਟਾਈਮਲਾਈਨ ਦੇਖਣਾ ਚਾਹੁੰਦੇ ਹਨ, ਜਦਕਿ ਇੰਪਲੀਮੈਂਟਰ ਸਰਗਰਮ ਨਿਰਦੇਸ਼ ਚਾਹੁੰਦੇ ਹਨ।

ਦੋਹਾਂ ਨੂੰ ਸਹਾਇਤਾ ਕਰੋ:

• ਹਰੇਕ ਫੇਜ਼ ਲਈ ਓਵਰਵਿਊ ਪੰਨੇ (ਕੀ, ਕਿਉਂ, ਪੂਰਵ-ਸ਼ਰਤਾਂ, ਸਫਲਤਾ ਮਾਪਦੰਡ)
• ਹਰੇਕ ਕੰਮ ਲਈ ਕਦਮ-ਦਰ-ਕਦਮ ਪੰਨੇ (ਇਹ ਕਰੋ, ਫਿਰ ਇਹ ਕਰੋ, ਉਮੀਦ ਕੀ ਨਤੀਜਾ ਹੋਵੇਗਾ, ਟ੍ਰਬਲਸ਼ੂਟਿੰਗ)

ਇਨ੍ਹਾਂ ਵਿਚਕਾਰ ਵੱਡੇ ਲਿੰਕ ਰੱਖੋ ਤਾਂ ਕਿ ਪੜ੍ਹਨ ਵਾਲਾ ਬਿਨਾਂ ਆਪਣੀ ਜਗ੍ਹਾ ਖੋਏ ਮੋਡ ਬਦਲ ਸਕੇ।

ਹਿੱਸੇਦਾਰਾਂ ਲਈ ਇੱਕ "ਇੱਕ ਨਜ਼ਰ'" ਪੇਜ਼ ਸ਼ਾਮਲ ਕਰੋ

ਇੱਕ ਸਾਰਾਂਸ਼ ਪੇਜ਼ ਜੋ ਹਿੱਸੇਦਾਰਾਂ ਦੇ ਸਵਾਲ ਫੁੱਟੀ ਤਰ੍ਹਾਂ ਜਵਾਬ ਦੇਵੇ: ਦਾਇਰਾ, ਟਾਈਮਲਾਈਨ, ਮੁੱਖ ਫੈਸਲੇ, ਮਲਕੀਅਤ, ਜੋਖਮ ਖੇਤਰ, ਅਤੇ ਇੱਕ ਛੋਟੀ ਸਥਿਤੀ ਚੈੱਕਲਿਸਟ। ਇਸਨੂੰ ਢਾਂਚੇ ਵਿੱਚ ਉੱਚੇ ਸਥਾਨ (/guide/at-a-glance/) ਤੇ ਰੱਖੋ ਅਤੇ ਗਾਈਡ ਹੋਮ ਤੋਂ ਲਿੰਕ ਕਰੋ।

ਜਦੋਂ ਤੁਹਾਡੀ ਵੈਬਸਾਈਟ ਸੱਚੇ ਮਾਈਗ੍ਰੇਸ਼ਨ ਫੇਜ਼ਾਂ ਨੂੰ ਨਕਲ ਕਰਦੀ ਹੈ—ਅਤੇ ਸੰਦਰਭ ਸਮੱਗਰੀ ਨੂੰ ਪ੍ਰਕਿਰਯਾਵਾਂ ਤੋਂ ਅਲੱਗ ਕਰਦੀ ਹੈ—ਤਾਂ ਤੁਹਾਡੀ ਸਮੱਗਰੀ ਭਰੋਸੇਯੋਗ ਅਤੇ ਤੇਜ਼ ਵਰਤੀ ਜਾਣਯੋਗ ਬਣ ਜਾਂਦੀ ਹੈ।

ਮਾਈਗ੍ਰੇਸ਼ਨ ਫੇਜ਼ ਦੇ ਅਨੁਸਾਰ ਸਮੱਗਰੀ ਆઉਟਲਾਈਨ ਡਿਜ਼ਾਈਨ ਕਰੋ

ਇੱਕ ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਵਧੀਆ ਪੜ੍ਹਦੇ ਸਮੇਂ ਉਹੀ ਪੇਜ਼ ਬਣਦਾ ਹੈ ਜੋ ਲੋਕ ਅਸਲ ਵਿੱਚ ਮਾਈਗ੍ਰੇਸ਼ਨ ਚਲਾਉਂਦੇ ਸਮੇਂ ਵਰਤਦੇ ਹਨ। ਪ੍ਰੋਡਕਟ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਦੇ ਬਜਾਏ, ਫੇਜ਼ਾਂ ਦੇ ਅਨੁਸਾਰ ਵਿਵਸਥਾ ਕਰੋ—ਤਾਂ ਕਿ ਪਾਠਕ ਜਦੋਂ ਸਾਈਟ ਖੋਲ੍ਹੇ ਤਾਂ ਉਹ ਦਰਜੇ 'ਤੇ ਹੋਕੇ ਅੱਗੇ ਕਰਨ ਯੋਗ ਕੰਮ ਵੇਖ ਸਕੇ।

ਮਾਈਗ੍ਰੇਸ਼ਨ ਫੇਜ਼ ਨਾਲ ਸ਼ੁਰੂ ਕਰੋ (ਆਪਣੇ ਪ੍ਰਧਾਨ ਅਧਿਆਇ)

ਹਰੇਕ ਫੇਜ਼ ਲਈ ਇੱਕ ਸਿਖਰ-ਸਤਹ ਖੰਡ ਬਣਾਓ, ਹਰ ਇੱਕ ਵਿੱਚ ਇੱਕੋ ਤਰ੍ਹਾਂ ਦੇ ਪੰਨੇ (ਓਵਰਵਿਊ, ਚੈੱਕਲਿਸਟ, ਡਿਲਿਵਰੇਬਲ, ਅਤੇ “ਚੰਗਾ ਕੀ ਹੁੰਦਾ”):

• Discovery: ਮੌਜੂਦਾ-ਅਵਸਥਾ ਇਨਵੈਂਟਰੀ, ਡਿਪੈਂਡੇਂਸੀਜ਼, ਰਿਸਕ ਰਜਿਸਟਰ, ਸਟੇਕਹੋਲਡਰ ਇੰਟਰਵਿਊ
• Design: ਟਾਰਗਟ ਆਰਕੀਟੈਕਚਰ, ਡੇਟਾ ਮੈਪਿੰਗ, ਸੁਰੱਖਿਆ ਮਾਡਲ, ਐਕਸੈਪਟੈਂਸ ਮਾਪਦੰਡ
• Build: ਮਾਹੌਲ ਸੈਟਅਪ, ਕੰਫਿਗਰੇਸ਼ਨ ਕਦਮ, ਆਟੋਮੇਸ਼ਨ ਸਕ੍ਰਿਪਟ, ਮਾਈਗ੍ਰੇਸ਼ਨ ਰਨਬੁੱਕ
• Test: ਟੈਸਟ ਪਲੈਨ, ਟੈਸਟ ਡੇਟਾ ਰਣਨੀਤੀ, ਪਰਫਾਰਮੈਂਸ ਚੈੱਕ, UAT ਸਾਈਨ-ਆਫ
• Cutover: ਕਟਓਵਰ ਯੋਜਨਾ, ਸੰਚਾਰ, ਡਾਊਨਟਾਈਮ ਉਮੀਦਾਂ, ਜਾ/ਨਹੀਂ-ਜਾਣ ਚੈੱਕਲਿਸਟ
• Post-migration: ਵੈਰੀਫਿਕੇਸ਼ਨ, ਮਾਨੀਟਰਨਿੰਗ, ਟਰੇਨਿੰਗ, ਲੈਗਸੀ ਸਿਸਟਮਾਂ ਦਾ ਡੀਕਮੀਸ਼ਨ

ਜੇ ਤੁਸੀਂ ਚੈੱਕਲਿਸਟ ਵਰਤਦੇ ਹੋ, ਉਹਨਾਂ ਨੂੰ ਨਿਰਧਾਰਤ ਪੰਨਿਆਂ ਵਜੋਂ ਰੱਖੋ (ਉਦਾਹਰਨ: “Cutover checklist” ਪੇਜ਼) ਤਾਂ ਜੋ ਪ੍ਰਿੰਟ ਜਾਂ ਸਾਂਝਾ ਕਰਨਾ ਆਸਾਨ ਹੋਵੇ।

ਗੌਰ ਪਹਿਲਾਂ ਜਾਣਕਾਰੀ ਪੰਨੇ ਜੋ ਭ੍ਰਮ ਰੋਕਦੇ ਹਨ

ਫੇਜ਼ ਸਮੱਗਰੀ ਤੱਕ ਪਹੁੰਚ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ, ਉਨਾਂ ਨੂੰ ਛੋਟਾ "Start here" ਸੈੱਟ ਦਿਓ:

• ਸ਼ਬਦਾਵਲੀ (ਤੁਸੀਂ tenant, environment, wave, cutover ਨਾਲ ਕੀ ਮਤਲਬ ਲੈਂਦੇ ਹੋ)
• ਭੂਮਿਕਾਵਾਂ ਅਤੇ ਜ਼ਿੰਮੇਵਾਰੀਆਂ (ਕੌਣ ਮਨਜ਼ੂਰੀ ਦਿੰਦਾ, ਕੌਣ ਚਲਾਉਂਦਾ, ਕੌਣ ਸਹਾਇਤਾ ਕਰਦਾ)
• ਸਿਸਟਮ ਲੋੜਾਂ (ਆਕਸੈਸ, ਨੈੱਟਵਰਕ ਨਿਯਮ, ਸਮਰਥਿਤ ਵਰਜ਼ਨ, ਟੂਲ)

ਜੇੜੇ ਫੈਸਲੇ ਹੋਂਦੇ ਹਨ, ਉਨ੍ਹਾਂ ਨੂੰ ਥਿਕ ਥਾਂ ਰੱਖੋ

ਮਾਈਗ੍ਰੇਸ਼ਨਾਂ ਵਿੱਚ ਰਸਤੇ 'ਚ ਫੋਰਕ ਆਉਂਦੇ ਹਨ। ਫੈਸਲਾ ਪੰਨੇ ਸਿੱਧੇ ਸੰਬੰਧਤ ਫੇਜ਼ ਦੇ ਅੰਦਰ ਰੱਖੋ:

• Discovery/Design ਵਿੱਚ, big-bang vs phased migration ਨੂੰ ਦਰਜ ਕਰੋ, ਮਿਟਿੰਗ, ਜੋਖਮ, ਅਤੇ ਸਿਫਾਰਸ਼ ਟੈਮਪਲੇਟ ਸਮੇਤ।
• Test/Cutover ਵਿੱਚ, go/no-go decision ਪੇਜ਼ ਰੱਖੋ ਜਿਸ ਵਿੱਚ ਲੋੜੀਂਦੇ ਇਨਪੁੱਟ (ਟੈਸਟ ਨਤੀਜੇ, ਰੋਲਬੈਕ ਤਿਆਰੀ, ਸਟੇਕਹੋਲਡਰ ਸਾਈਨ-ਆਫ) ਹੋਣ।

ਅਸਲੀ ਦੁਨੀਆ ਦੇ ਸਿੰਨਾਰਿਓ ਅਤੇ ਰਿਕਵਰੀ ਲਈ ਥਾਂ ਬਣਾਓ

"Common scenarios" ਹਬ ਸ਼ਾਮਲ ਕਰੋ ਜੋ ਇੱਕੋ ਗਾਈਡ ਨੂੰ ਵੱਖ-ਵੱਖ ਪ੍ਰਸੰਗਾਂ ਲਈ ਅਨুকੂਲ ਕਰਦਾ ਹੈ:

• ਛੋਟੀਆਂ ਸੰਗਠਨਾਂ ਜਿਨ੍ਹਾਂ ਕੋਲ ਸੀਮਤ IT ਸਹਾਇਤਾ ਹੁੰਦੀ ਹੈ
• ਨਿਯਮਤ ਸੰਸਥਾਵਾਂ (ਆਡਿਟ ਸਬੂਤ, ਮਨਜ਼ੂਰੀਆਂ, ਰੀਟੇਨਸ਼ਨ)
• ਕਈ ਰੀਜਨ/ਟਾਈਮਜ਼ੋਨ (ਵੇਵਜ਼, ਸੰਚਾਰ, ਸਹਾਇਤਾ ਕਵਰੇਜ)

ਅੰਤ ਵਿੱਚ, ਟ੍ਰਬਲਸ਼ੂਟਿੰਗ ਅਤੇ ਰੋਲਬੈਕ ਨੂੰ ਇੱਕ ਪਹਿਲੀ-ਕਲਾਸ ਸਮੱਗਰੀ ਵਜੋਂ ਰੱਖੋ, ਨਾ ਕਿ ਪੈਰੂ-ਐਪੈਂਡਿਕਸ: ਹਰ ਫੇਜ਼ چੈੱਕਲਿਸਟ ਤੋਂ ਰੋਲਬੈਕ ਕਦਮਾਂ ਦੇ ਲਿੰਕ ਰੱਖੋ, ਅਤੇ ਇੱਕ ਸਿੰਗਲ "Rollback procedure" ਪੇਜ਼ ਰੱਖੋ ਜੋ ਘਟਨਾਵਾਂ ਦੌਰਾਨ ਆਸਾਨੀ ਨਾਲ ਮਿਲ ਜਾਵੇ।

ਦੁਹਰਾਏ ਜਾਣ ਯੋਗ ਪੇਜ਼ ਟੈਮਪਲੇਟ ਬਣਾਓ

ਟੈਮਪਲੇਟ ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਨੂੰ ਪੰਨਿਆਂ ਦੇ ਢੇਰ ਤੋਂ ਇਕ ਅਨੁਮਾਨਯੋਗ ਅਨੁਭਵ ਬਣਾਉਂਦੇ ਹਨ। ਪੜ੍ਹਨ ਵਾਲੇ ਨੂੰ ਹਰ ਪੰਨੇ 'ਤੇ ਤੁਹਾਡੇ ਦਸਤਾਵੇਜ਼ ਨੂੰ "ਸਿੱਖਣਾ" ਨਹੀਂ ਚਾਹੀਦਾ—ਉਹ ਤੁਰੰਤ ਢਾਂਚਾ ਪਛਾਣਣ, ਜੋ ਲੋੜ ਹੈ ਉਹ ਲੱਭਣ ਅਤੇ ਅੱਗੇ ਕੀ ਕਰਨਾ ਹੈ ਇਹ ਜਾਣਣ ਯੋਗ ਹੋਣ।

1) ਮਾਈਗ੍ਰੇਸ਼ਨ ਓਵਰਵਿਊ ਪੇਜ਼ ਟੈਮਪਲੇਟ

ਹਰੇਕ ਮਾਈਗ੍ਰੇਸ਼ਨ (ਜਾਂ ਹਰੇਕ ਮੁਖ ਫੇਜ਼) ਲਈ ਇੱਕ ਲਗਾਤਾਰ ਓਵਰਵਿਊ ਫਾਰਮੈਟ ਵਰਤੋ। ਇਸਨੂੰ ਸਕੈਨ ਕਰਨਯੋਗ ਰੱਖੋ:

• ਕਿਸ ਲਈ ਹੈ: ਪ੍ਰਭਾਵਿਤ ਭੂਮਿਕਾਵਾਂ ਅਤੇ ਟੀਮਾਂ
• ਕੀ ਬਦਲ ਰਿਹਾ ਹੈ: ਸਿਸਟਮ, ਡੇਟਾ, ਅਤੇ ਉਪਭੋਗਤਾ-ਸਾਮ੍ਹਣੇ ਪ੍ਰਭਾਵ
• ਟਾਈਮਲਾਈਨ: ਮੁੱਖ ਤਰੀਕਾਂ, ਫਰੀਜ਼ ਵਿੰਡੋ, ਅਤੇ ਡਿਪੈਂਡੇੰਸੀਜ਼
• ਜੋਖਮ: ਮੁੱਖ ਫੇਲਿਅਰ ਮੋਡ ਅਤੇ ਉਨ੍ਹਾਂ ਨੂੰ ਕਿਵੇਂ ਘਟਾਇਆ ਜਾਵੇ
• ਪੂਰਵ-ਸ਼ਰਤਾਂ: ਆਕਸੈਸ, ਟੂਲ, ਖਾਤੇ, ਅਤੇ ਮਨਜ਼ੂਰੀਆਂ ਜੋ ਲੋੜੀਂਦੀਆਂ ਹਨ

ਸਾਫ਼ ਕਾਲ-ਟੂ-ਐਕਸ਼ਨ ਨਾਲ ਖਤਮ ਕਰੋ, ਉਦਾਹਰਨ "Start pre-migration checks" ਜੋ /checklists/pre-migration ਨੂੰ ਲਿੰਕ ਕਰਦਾ ਹੈ।

2) ਸਟੇਪ ਪੇਜ਼ ਟੈਮਪਲੇਟ (ਸੰਘੀ ਪੰਨਾ)

ਇੱਕ ਸਟੇਪ ਪੇਜ਼ ਰੇਸੀਪੀ ਵਾਂਗ ਪੜ੍ਹਨਾ ਚਾਹੀਦਾ ਹੈ, ਨ ਕਿ ਨਾਵਲ ਵਾਂਗ। ਸੁਝਾਏ ਹਿੱਸੇ:

• ਲক্ষ্য: ਇੱਕ ਵਾਕ ਵਿੱਚ ਨਤੀਜੇ ਦੀ ਵਰਣਨਾ
• ਇਨਪੁੱਟ: ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਜੋ ਲੋੜ ਹੈ (ਫਾਈਲਾਂ, ਕ੍ਰੈਡੇਨਸ਼ਲ, ਪਰਮਿਸ਼ਨ)
• ਕਦਮ: ਨੰਬਰਵਾਰ ਕਾਰਵਾਈਆਂ ਸਹਿਤ ਉਮੀਦ ਕੀ ਨਤੀਜਾ ਹੋਵੇਗਾ
• ਆਉਟਪੁੱਟ: ਖਤਮ ਹੋਣ 'ਤੇ ਕੀ ਮੌਜੂਦ ਹੋਣਾ ਚਾਹੀਦਾ (ਰੇਕਾਰਡ, ਸੈਟਿੰਗਜ਼)
• ਤਸਦੀਕ: ਕਿਵੇਂ ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ ਇਹ ਕੰਮ ਕੀਤਾ (ਸਕ੍ਰੀਨ, ਰਿਪੋਰਟ, ਨਮੂਨਾ ਕੁਏਰੀ)
• ਸਮਾਂ ਅਨੁਮਾਨ: ਯੋਜਨਾ ਲਈ ਉਮੀਦ ਰੱਖੋ

ਜਦੋਂ ਜਾਣਿਆ-ਪਹਚਾਨਾ ਆਮ ਤੌਰ 'ਤੇ ਤਰੱਕੀਆਂ ਹੋਣ, ਇਸ 'ਚ ਛੋਟਾ "Troubleshooting" ਕਾਲਆਉਟ ਜੋੜੋ।

3) ਚੈੱਕਲਿਸਟ ਟੈਮਪਲੇਟ

ਚੈੱਕਲਿਸਟ ਕੋਆਰਡੀਨੈਸ਼ਨ ਨਾ-ਸਫਲਤਾਵਾਂ ਘਟਾਉਂਦੇ ਹਨ। ਉਨ੍ਹਾਂ ਨੂੰ ਇੱਕ ਟੇਬਲ ਵਜੋਂ ਸੰਰਚਿਤ ਕਰੋ:

• ਟਾਸਕ (ਛੋਟਾ, ਕਾਰਜਪੂਰਕ)
• ਮਾਲਕ (ਭੂਮਿਕਾ ਜਾਂ ਟੀਮ)
• ਸਥਿਤੀ (Not started / In progress / Blocked / Done)
• ਲਿੰਕਸ ਸਬੰਧਤ ਸਟੇਪ ਪੰਨਿਆਂ ਵੱਲ

ਇਸ ਨਾਲ ਤੁਹਾਡੀ "migration checklist page" ਮੀਟਿੰਗਾਂ ਵਿੱਚ ਵਰਤਣਯੋਗ ਅਤੇ ਪ੍ਰਿੰਟ ਕਰਨਯੋਗ ਬਣ ਜਾਂਦੀ ਹੈ।

4) ਸੰਦਰਭ ਟੈਮਪਲੇਟ

ਸੰਦਰਭ ਪੰਨੇ ਸਖ਼ਤ ਅਤੇ ਤੱਥ-ਅਧਾਰਤ ਹੋਣੇ ਚਾਹੀਦੇ ਹਨ। ਸ਼ਾਮਿਲ ਕਰੋ:

• ਫੀਲਡ/ਪਰਿਭਾਸ਼ਾਵਾਂ (ਡੇਟਾ ਮੈਪਿੰਗ ਨੋਟਸ)
• API ਸੀਮਾਵਾਂ ਅਤੇ ਰੇਟ ਨੀਤੀਆਂ
• ਸਮਰਥਿਤ ਵਰਜ਼ਨ
• ਪਾਬੰਦੀਆਂ ਅਤੇ ਐਜ ਕੇਸ

5) FAQ ਟੈਮਪਲੇਟ

ਜਵਾਬ ਛੋਟੇ ਰੱਖੋ, ਫਿਰ ਗਹਿਰਾਈ ਲਈ ਲਿੰਕ ਦਿਓ:

• ਇੱਕ ਪੈਰਾ ਜਵਾਬ
• "Learn more" ਲਿੰਕ ਸਟੇਪ, ਚੈੱਕਲਿਸਟ, ਜਾਂ ਸੰਦਰਭ ਪੰਨਿਆਂ ਵੱਲ

ਤੁਸੀਂ ਇਨ੍ਹਾਂ ਟੈਮਪਲੇਟਾਂ ਨੂੰ ਆਪਣੇ CMS ਵਿੱਚ ਸ਼ੁਰੂਆਤੀ ਪੰਨਿਆਂ ਵਜੋਂ ਰੱਖ ਸਕਦੇ ਹੋ ਤਾਂ ਹਰ ਨਵੇਂ ਪੰਨੇ ਦੀ ਸ਼ੁਰੂਆਤ ਸਹੀ ਢਾਂਚੇ ਨਾਲ ਹੋਵੇ।

ਨੈਵੀਗੇਸ਼ਨ, ਖੋਜ ਅਤੇ ਪਾਠਕ ਫਲੋ ਬਣਾਓ

ਇੱਕ ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਉਸ ਵੇਲੇ ਸਫਲ ਹੁੰਦੀ ਹੈ ਜਦੋਂ ਪੜ੍ਹਨ ਵਾਲਾ ਦੋ ਸਵਾਲ ਤੁਰੰਤ ਜਵਾਬ ਦੇ ਸਕੇ: "ਮੈਂ ਕਿੱਥੇ ਹਾਂ?" ਅਤੇ "ਅੱਗੇ ਕੀ ਕਰਨਾ ਹੈ?" ਚੰਗੀ ਨੈਵੀਗੇਸ਼ਨ ਡਰੌਪ-ਆਫ ਘਟਾਉਂਦੀ ਹੈ, ਸਹਾਇਤਾ ਟਿਕਟਾਂ ਘਟਾਉਂਦੀ ਹੈ, ਅਤੇ ਨਾਨ-ਟੈਕਨੀਕਲ ਪਾਠਕਾਂ ਨੂੰ ਕਦਮ-ਦਰ-ਕਦਮ ਆਤਮ-ਵਿਸ਼ਵਾਸ ਰੱਖਣ ਵਿੱਚ ਮਦਦ ਕਰਦੀ ਹੈ।

ਗਲੋਬਲ ਨੈਵੀਗੇਸ਼ਨ ਨੂੰ ਯੂਜ਼ਰ ਦੀ ਮਨਸ਼ਾ ਦੇ ਅਨੁਸਾਰ ਪਰਿਭਾਸ਼ਿਤ ਕਰੋ

ਟੌਪ ਨੈਵੀਗੇਸ਼ਨ ਨੂੰ ਸਧਾਰਨ ਅਤੇ ਕਾਰਜ-ਕੇਂਦਰਿਤ ਰੱਖੋ। ਇੱਕ ਮਜ਼ਬੂਤ ਬੇਸਲਾਈਨ:

• Guide (ਮੁੱਖ, ਲਗਾਤਾਰ ਪਾਥ)
• Checklists (ਪ੍ਰਿੰਟ ਕਰਨਯੋਗ ਜਾਂ ਸਕੈਨ ਕਰਨਯੋਗ README)
• Templates (ਈਮੇਲ, ਸੰਚਾਰ ਯੋਜਨਾ, ਡੇਟਾ ਮੈਪ)
• Troubleshooting (ਆਮ ਗਲਤੀਆਂ ਅਤੇ ਤੁਰੰਤ ਠੀਕ)
• Release notes (ਕੀ ਬਦਲਿਆ)

ਇਹ ਢਾਂਚਾ ਵੱਖ-ਵੱਖ ਦਰਸ਼ਕਾਂ ਨੂੰ ਬਿਨਾਂ ਪੂਰੇ ਗਾਈਡ ਵਿੱਚ ਖੋਜ ਕੀਤੇ ਇਹ ਜਾਣਨ ਵਿੱਚ ਮਦਦ ਕਰਦਾ ਹੈ ਕਿ ਉਹਨੂੰ ਕੀ ਲੋੜ ਹੈ।

ਸਾਫ਼ ਕਦਮ-ਦਰ-ਕਦਮ ਰਾਹ ਲਈ ਖੱਬੇ-ਪਾਸੇ ਨੈਵੀਗੇਸ਼ਨ ਦੀ ਵਰਤੋਂ ਕਰੋ

ਮੁੱਖ Guide ਲਈ, ਖੱਬੇ-ਪਾਸੇ ਨੈਵੀਗੇਸ਼ਨ ਵਰਤੋ ਜੋ ਕਦਮਾਂ ਨੂੰ ਮਾਨਨੇਯੋਗ ਫੇਜ਼ਾਂ ਵਿੱਚ ਗਰੁੱਪ ਕਰਦਾ ਹੈ (ਉਦਾਹਰਨ: Prepare → Test → Migrate → Validate)। ਗਰੁੱਪਿੰਗ ਦਿਖਾਓ ਤਾਂ ਕਿ ਪੜ੍ਹਨ ਵਾਲਾ ਤਰੱਕੀ ਮਹਿਸੂਸ ਕਰੇ, ਸਿਰਫ ਲੰਬੀ ਸੂਚੀ ਨਹੀਂ।

ਜੇ ਸੰਭਵ ਹੋਵੇ, ਹਾਈਲਾਈਟ ਕਰੋ:

• ਮੌਜੂਦਾ ਕਦਮ
• ਪੂਰੇ ਹੋਏ ਬਨਾਮ ਆਉਣ ਵਾਲੇ ਕਦਮ
• ਹਰ ਪੰਨੇ 'ਤੇ ਅਨੁਮਾਨਿਤ ਸਮਾਂ ਜਾਂ "ਤੁਹਾਨੂੰ ਲੋੜ ਪਏਗੀ" ਪੂਰਵ-ਸ਼ਰਤਾਂ

ਖੋਜ ਜੋ ਮਦਦਗਾਰ ਵਾਂਗ ਕੰਮ ਕਰੇ, ਨਾ ਕਿ ਫੰਦਾ

ਪੰਨੇ ਦੇ ਉਪਰ ਇੱਕ ਪ੍ਰਮੁੱਖ ਖੋਜ ਬਾਕਸ ਰੱਖੋ, ਅਤੇ ਜੇ ਪਲੇਟਫਾਰਮ ਸਮਰਥਨ ਕਰਦਾ ਹੈ ਤਾਂ autocomplete ਚਾਲੂ ਕਰੋ। Autocomplete ਲੋਕਾਂ ਨੂੰ ਸਹੀ ਸ਼ਬਦਾਂ ਦੀ ਨਸੀਹਤ ਦਿੰਦਾ ਹੈ (ਜਿਵੇਂ "SSO", "data export", "rollback") ਅਤੇ "ਕੋਈ ਨਤੀਜਾ ਨਹੀਂ" ਫ੍ਰੈਸਟਰੇਸ਼ਨ ਨੂੰ ਘਟਾਉਂਦਾ ਹੈ।

breadcrumb ਅਤੇ ਸਟੇਪ ਲਿੰਕ ਨਾਲ ਦਿਸ਼ਾ-ਭਾਵ ਮਜ਼ਬੂਤ ਕਰੋ

Breadcrumbs ਵਰਤੋਂ ਤਾਂ ਕਿ ਪੜ੍ਹਨ ਵਾਲਾ ਬਿਨਾਂ ਸੰਦਰਭ ਗੁਆਏ ਮੁੜ ਸਕੇ।

ਹਰ ਸਟੇਪ ਪੇਜ਼ ਦੇ ਤਲੀਏ ਸਾਫ਼ "Next step" ਅਤੇ "Previous step" ਲਿੰਕ ਸ਼ਾਮਿਲ ਕਰੋ। ਇਹ ਛੋਟੀ ਡੀਟੇਲ ਭਰਪਾਈ ਰੱਖਦੀ ਹੈ ਅਤੇ ਪੜ੍ਹਨ ਵਾਲੇ ਨੂੰ ਹਰ ਕੰਮ ਪਿੱਛੋਂ ਮੈਨੂ 'ਤੇ ਵਾਪਸ ਜਾਣ ਤੋਂ ਬਚਾਉਂਦੀ।

ਸਾਫ਼ ਲਿਖੋ ਅਤੇ ਠੀਕ ਵਿਜ਼ੂਅਲ ਜੋੜੋ

ਇੱਕ ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਤਦ ਹੀ ਸਫਲ ਹੁੰਦੀ ਹੈ ਜਦੋਂ ਲੋਕ ਇਸ 'ਤੇ ਤੇਜ਼ੀ ਨਾਲ ਕੰਮ ਕਰ ਸਕਣ। ਲਿਖੋ ਜਿਵੇਂ ਕਿ ਪਾਠਕ ਤੇਜ਼-ਚਿੰਤਕ ਹੈ: ਛੋਟੀ ਵਾਕ-ਰਚਨਾ, ਇੱਕ ਪੈਰਾਗ੍ਰਾਫ ਵਿੱਚ ਇੱਕ ਵਿਚਾਰ, ਅਤੇ ਹਰ ਪੰਨੇ ਦੇ ਅੰਤ 'ਤੇ ਇੱਕ ਸਪਸ਼ਟ "ਅੱਗੇ ਕੀ ਕਰਨਾ ਹੈ"।

ਅਕ੍ਰੋਨਿਮ ਪਹਿਲੀ ਵਾਰੀ ਵਰਤੇ ਜਾਣ 'ਤੇ ਪਰਿਭਾਸ਼ਿਤ ਕਰੋ (ਉਦਾਹਰਨ: "SSO (single sign-on)")। ਸਾਫ਼ ਕਿਰਿਆ-ਸ਼ਬਦਾਂ ਨੂੰ ਤਰਜੀਹ ਦਿਓ ("export", "map", "validate") ਬਜਾਏ ਅਬਸਟ੍ਰੈਕਟ ਫਰੇਜ਼ ਦੇ। ਜੇ ਕਿਸੇ ਉਤਪਾਦ-ਖਾਸ ਸ਼ਬਦ ਦੀ ਲੋੜ ਹੋਵੇ, ਉਸ ਦੇ ਹੇਠਾਂ ਇੱਕ ਇੱਕ-ਲਾਈਨ ਵਿਆਖਿਆ ਜੋੜੋ।

ਗਲਤਫਹਮੀ ਘਟਾਉਣ ਵਾਲੇ ਵਿਜ਼ੂਅਲ ਵਰਤੋਂ

ਵਿਜ਼ੂਅਲ ਉਹਨਾਂ ਲਈ ਸਭ ਤੋਂ ਵਧੀਆ ਹਨ ਜਦੋਂ ਉਹ ਸਿਮਾਵਾਂ ਅਤੇ ਫਲੋ ਨੂੰ ਸਮਝਾਉਂਦੇ ਹਨ। ਸਧਾਰਨ ਡਾਇਗ੍ਰਾਮਾਂ ਜੋੜੋ:

• ਡੇਟਾ ਫਲੋ (ਕਿੱਥੋਂ ਡੇਟਾ ਆਉਂਦਾ ਹੈ, ਕਿਵੇਂ ਬਦਲਦਾ ਹੈ, ਅਤੇ ਕਿੱਥੇ ਪੈਂਦਾ ਹੈ)
• ਸਿਸਟਮ ਸੀਮਾਵਾਂ (ਕੀ ਸਕੋਪ ਵਿੱਚ ਹੈ ਬਨਾਮ ਬਾਹਰ)
• ਆਈਡੈਂਟੀਟੀ/ਆਥ ਫਲੋ (ਕੌਣ ਕਿੱਥੇ Authenticate ਕਰਦਾ ਹੈ)

ਹਰੇਕ ਡਾਇਗ੍ਰਾਮ ਲਈ ਇੱਕ ਕਾਰਜਪੂਰਨ ਕੈਪਸ਼ਨ ਰੱਖੋ: ਪੜ੍ਹਨ ਵਾਲੇ ਨੂੰ ਕੀ ਧਿਆਨ ਦੇਣਾ ਚਾਹੀਦਾ ਹੈ (“Customer IDs are generated in the new CRM, not imported”). ਜੇ ਵਿਜ਼ੂਅਲ ਸਪਸ਼ਟ ਨਹੀਂ, ਤਾਂ ਹੇਠਾਂ 2–3 ਵਾਕਾਂ ਦੀ ਵਿਆਖਿਆ ਜੋੜੋ।

ਜਿੱਥੇ ਉਮੀਦ ਕੀਤੀ ਜਾਂਦੀ ਹੈ ਉਥੇ ਮੈਪਿੰਗ ਟੇਬਲ ਜੋੜੋ

ਫੀਲਡ ਅਤੇ ਓਬਜੇਕਟ ਮੈਪਿੰਗ ਟੇਬਲ ਵਿੱਚ ਪੜ੍ਹਨਾ ਆਸਾਨ ਹੁੰਦਾ ਹੈ। ਇਕੋ ਢਾਂਚਾ ਵਰਤੋ:

ਐਜ ਕੇਸ (ਖਾਲੀ ਮੁੱਲ, ਖ਼ਾਸ ਅੱਖਰ, ਟਾਈਮ ਜੋਨ) ਸ਼ਾਮਿਲ ਕਰੋ ਕਿਉਂਕਿ ਇੱਥੇ ਮਾਈਗ੍ਰੇਸ਼ਨਾਂ ਅਕਸਰ ਫੇਲ ਹੁੰਦੀਆਂ ਹਨ।

ਕਾਪੀ-ਪੇਸਟ ਸਨਿੱਪੇਟ ਦਿਓ (ਅਤੇ ਦੱਸੋ ਕਦੋਂ ਵਰਤਣੇ ਹਨ)

ਪੜ੍ਹਨ ਵਾਲੇ "ਤੁਰੰਤ ਚਲਾਉਣ ਯੋਗ" ਬਲੌਕਾਂ ਨੂੰ ਪਸੰਦ ਕਰਦੇ ਹਨ, ਪਰ ਉਹਨਾਂ ਨੂੰ ਪ੍ਰਸੰਗ ਚਾਹੀਦਾ ਹੈ: ਪੂਰਵ-ਸ਼ਰਤ, ਕਿੱਥੇ ਚਲਾਉਣਾ ਹੈ, ਅਤੇ ਕਾਮਯਾਬੀ ਕੀ ਦਿਖੇਗੀ।

# Export users from the old system
oldsys export users --format=csv --out=users.csv

ਚੇਤਾਵਨੀਆਂ ਅਤੇ ਪੂਰਵ-ਸ਼ਰਤਾਂ ਨੂੰ ਸਥਿਰ ਕਰੋ

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

ਮਦਦਗਾਰ ਇੰਟਰਐਕਟਿਵ ਤੱਤ ਜੋੜੋ (ਬਿਨਾਂ ਜ਼ਰੂਰੀ ਜਟਿਲਤਾ)

ਇੰਟਰਐਕਟਿਵ ਫੀਚਰ ਥੋੜ੍ਹੇ-ਪ੍ਰਯੋਗਿਕ ਤਰੀਕੇ ਨਾਲ ਗਾਈਡ ਨੂੰ "ਜਿਂਦਾ" ਮਹਿਸੂਸ ਕਰਵਾ ਸਕਦੇ ਹਨ—ਪਰ ਸਿਰਫ ਜੇ ਉਹ ਪੜ੍ਹਨ ਵਾਲੇ ਦਾ ਕੰਮ ਘਟਾਉਂਦੇ ਹੋਣ। мақਸਦ ਐਪ ਬਣਾਉਣਾ ਨਹੀਂ; ਇਹ ਹੈ ਕਿ ਮਹੱਤਵਪੂਰਨ ਪੰਨਿਆਂ ਨੂੰ ਉਹ ਟੂਲ ਬਨਾਉਣਾ ਜੋ ਲੋਕ ਯੋਜਨਾ, ਕਾਰਗੁਜ਼ਾਰੀ, ਅਤੇ ਤਸਦੀਕ ਦੌਰਾਨ ਵਰਤ ਸਕਣ।

"ਕਰਯੋਗ" ਇੰਟਰਐਕਸ਼ਨਾਂ ਨਾਲ ਸ਼ੁਰੂ ਕਰੋ

ਇੰਟਰਐਕਟਿਵ ਚੈੱਕਲਿਸਟ (ਪ੍ਰਿੰਟੇਬਲ + ਡਾਊਨਲੋਡਯੋਗ): ਪੇਜ਼ 'ਤੇ ਇੱਕ ਚੈੱਕਲਿਸਟ ਰੱਖੋ ਜੋ ਤੇਜ਼ੀ ਨਾਲ ਪ੍ਰਗਤੀ ਟਰੈਕ ਕਰਨ ਲਈ ਹੋਵੇ, ਅਤੇ ਟੀਮਾਂ ਲਈ ਸਪ੍ਰੈਡਸ਼ੀਟ ਡਾਊਨਲੋਡ ਦੀਆਂ ਵਿਕਲਪ ਦਿੱਤੀਆਂ ਹਨ। ਦਿਓ:

• ਇੱਕ ਪ੍ਰਿੰਟੇਬਲ ਦ੍ਰਿਸ਼ (ਸਾਫ਼-ਲਏਆਊਟ, ਘੱਟ-ਨੈਵੀਗੇਸ਼ਨ)
• CSV ਡਾਊਨਲੋਡ
• "Copy to Google Sheet" ਲਿੰਕ (ਜਾਂ ਇੱਕ ਸਧਾਰਣ ਟੈਮਪਲੇਟ ਲਿੰਕ)

ਚੈੱਕਲਿਸਟ ਨੂੰ ਮਾਈਗ੍ਰੇਸ਼ਨ ਚੈੱਕਲਿਸਟ ਪੇਜ਼ ਦੇ ਉਪਰ ਰੱਖੋ ਤਾਂ ਕਿ ਇਹ ਡਿਫਾਲਟ ਸ਼ੁਰੂਆਤ ਬਣ ਜਾਵੇ।

ਟਾਈਮਲਾਈਨ ਜਾਂ ਮਾਈਲਸਟੋਨ ਵਿਊ: ਕਈ ਪਾਠਕ ਯੋਜਨਾ ਬਣਾਉਣ ਲਈ ਮਾਰਗ ਦਿਖਾਉਂਦੇ ਹਨ। ਇੱਕ ਹਲਕਾ-ਫੁਲਕਾ "ਮਾਈਲਸਟੋਨ" ਬਲੌਕ ਜੋੜੋ ਜੋ ਕੰਮਾਂ ਨੂੰ ਫੇਜ਼ਾਂ ਅਨੁਸਾਰ ਗਰੁੱਪ ਕਰੇ। ਸਧਾਰਨ ਰੱਖੋ: ਹਰ ਮਾਈਲਸਟੋਨ ਲਈ ਇੱਕ ਲਾਈਨ, ਅਨੁਮਾਨਿਤ ਕੋਸ਼ਿਸ਼ ਰੇਂਜ ਅਤੇ ਡਿਪੈਂਡੇੰਸੀਜ਼।

ਪਾਠਕਾਂ ਨੂੰ ਪਾਥ ਚੁਣਨ ਵਿੱਚ ਮਦਦ ਕਰੋ

ਫੈਸਲਾ ਮਦਦਗਾਰ ਪ੍ਰਸ਼ਨਾਵਲੀ: ਇੱਕ ਛੋਟੀ, ਗੈਰ-ਟੈਕਨੀਕਲ ਪ੍ਰਸ਼ਨਾਵਲੀ (5–8 ਸਵਾਲ) ਇੱਕ ਮਾਈਗ੍ਰੇਸ਼ਨ ਪਾਥ ਦੀ ਸਿਫਾਰਸ਼ ਕਰ ਸਕਦੀ ਹੈ (lift-and-shift vs re-platform vs phased)। ਨਤੀਜਿਆਂ ਨੂੰ ਵਜਹ ਸਮਝਾਓ: ਕਿਉਂ ਸਜ਼ੇਸ਼ਨ ਆਇਆ ਅਤੇ ਸਬੰਧਤ ਪਾਥ ਪੰਨੇ ਦੀ ਲਿੰਕ ਦਿਓ।

ਸਫਲਤਾ ਨੂੰ ਮਾਪਯੋਗ ਬਣਾਓ

ਤਸਦੀਕ ਫਾਰਮ: "ਮੁੱਕ ਗਿਆ" ਨੂੰ ਨਿਰੀਖਣਯੋਗ ਚੈੱਕ ਬਣਾਓ। ਬੇਸਲਾਈਨ ਅਤੇ ਬਾਅਦ ਮੁੱਲਾਂ ਲਈ ਫ਼ਿਲ-ਇਨ ਫੀਲਡ ਦਿਓ (ਰਿਸਪਾਂਸ ਸਮਾਂ, ਐਰਰ ਦਰ, ਯੂਜ਼ਰ ਸਾਈਨ-ਇਨ, ਡੇਟਾ ਰਿਕਨਸਿਲੀਏਸ਼ਨ ਗਿਣਤੀਆਂ)। ਪੜ੍ਹਨ ਵਾਲਾ ਇਹ ਨਤੀਜੇ ਆਪਣੀਆਂ ਅੰਦਰੂਨੀ ਸਥਿਤੀ ਰਿਪੋਰਟਾਂ ਵਿੱਖੇ ਪੇਸਟ ਕਰ ਸਕਦਾ ਹੈ।

ਟ੍ਰਬਲਸ਼ੂਟਿੰਗ ਤੇਜ਼ ਕਰੋ

ਟ੍ਰਬਲਸ਼ੂਟਿੰਗ ਫਿਲਟਰ: ਲੰਬੇ FAQ ਦੀ ਥਾਂ, ਪੜ੍ਹਨ ਵਾਲੇ ਨੂੰ ਲੱਛਣ ਮੁਤਾਬਕ ਫਿਲਟਰ ਕਰਨ ਦਿਓ (ਉਦਾਹਰਨ: "login failures"), ਫੇਜ਼ ("cutover"), ਜਾਂ ਕੰਪੋਨੈਂਟ ("database") ਦੇ ਅਧਾਰ 'ਤੇ। ਫਿਲਟਰ ਸਥਿਰ ਅਤੇ ਤੇਜ਼ ਰੱਖੋ—ਕੋਈ ਜਟਿਲ ਬੈਕਐਂਡ ਦੀ ਲੋੜ ਨਹੀਂ।

ਜੇ ਤੁਹਾਨੂੰ ਕਿਸੇ ਇੰਟਰਐਕਸ਼ਨ ਨੂੰ ਸ਼ਾਮਿਲ ਕਰਨ ਵਿੱਚ ਨਿਹਾਇਤੀ ਸੰਦੇਹ ਹੈ, ਇੱਕ ਨਿਯਮ ਵਰਤੋਂ: ਇਹ ਕੋਈ ਅਸਲ ਮਾਈਗ੍ਰੇਸ਼ਨ ਕਾਲ 'ਤੇ ਸਮਾਂ ਬਚਾਉਣਾ ਚਾਹੀਦਾ ਹੈ।

ਵੈਬਸਾਈਟ ਪਲੇਟਫਾਰਮ, ਹੋਸਟਿੰਗ, ਅਤੇ ਵਰਕਫਲੋ ਚੁਣੋ

ਸਭ ਤੋਂ ਵਧੀਆ ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਸਾਈਟ ਪਾਠਕਾਂ ਲਈ ਸਧਾਰਣ ਮਹਿਸੂਸ ਕਰਦੀ ਹੈ ਕਿਉਂਕਿ ਆਧਾਰਕ ਚੋਣਾਂ ਸਪੱਸ਼ਟ ਹੁੰਦੀਆਂ ਹਨ: ਸਮੱਗਰੀ ਕਿੱਥੇ ਰਹੇਗੀ, ਇਹ ਕਿਵੇਂ ਪ੍ਰਕਾਸ਼ਿਤ ਹੋਵੇਗੀ, ਅਤੇ ਕੌਣ ਇਸਦੀ ਦੇਖਭਾਲ ਕਰੇਗਾ।

ਆਪਣੀ ਟੀਮ ਨਾਲ ਮੇਲ ਖਾਣ ਵਾਲਾ ਪਲੇਟਫਾਰਮ ਚੁਣੋ

Static site generator (SSG) (ਉਦਾਹਰਨ: ਸਮੱਗਰੀ Markdown ਵਿੱਚ, ਸਾਈਟ HTML ਵਿੱਚ ਬਿਲਡ ਹੋਵੇ)।

• ਫਾਇਦੇ: ਤੇਜ਼, ਘੱਟ ਹੋਸਟਿੰਗ ਖਰਚ, Git ਵਿੱਚ ਵੱਧ-ਅਸਾਨ ਵਰਜ਼ਨਿੰਗ, "ਸਟੈਪ + ਚੈੱਕਲਿਸਟ" ਲਈ ਸ਼ਾਨਦਾਰ।
• ਨੁਕਸਾਨ: ਆਮ ਤੌਰ 'ਤੇ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਵਾਲੇ ਕਿਸੇ ਦੀ ਲੋੜ; ਪ੍ਰੀਵਿਊ ਅਤੇ ਐਡੀਟਿੰਗ "Word-ਵਾਂਗ" ਮਹਿਸੂਸ ਨਹੀਂ ਕਰ ਸਕਦੇ।

ਡੈਡੀਕੇਟਿਡ ਡੌਕਸ ਪਲੇਟਫਾਰਮ (ਹੋਸਟਡ ਡੌਕਯੂਮੈਂਟੇਸ਼ਨ ਟੂਲ)।

• ਫਾਇਦੇ: ਤੇਜ਼ ਸੈਟਅਪ, ਬਿਲਟ-ਇਨ ਨੈਵੀਗੇਸ਼ਨ/ਖੋਜ, ਰੋਲ/ਪਰਮੀਸ਼ਨ, ਘੱਟ ਇੰਜੀਨੀਅਰਿੰਗ ਯਤਨ।
• ਨੁਕਸਾਨ: ਮਾਸਿਕ ਖਰਚ, ਥੀਮਿੰਗ ਸੀਮਿਤ, ਸਮੱਗਰੀ ਪੋਰਟੇਬਿਲਟੀ ਵੱਖ-ਵੱਖ ਹੋ ਸਕਦੀ ਹੈ।

CMS (ਜਿਵੇਂ WordPress ਜਾਂ headless CMS)।

• ਫਾਇਦੇ: ਪਰਚੀਤ ਐਡੀਟਰ, ਲਚਕੀਲੇ ਪੰਨੇ, ਆਸਾਨ ਮਨਜ਼ੂਰੀ ਪ੍ਰਕਿਰਿਆ।
• ਨੁਕਸਾਨ: ਪ੍ਰਦਰਸ਼ਨ ਅਤੇ ਸਥਿਰਤਾ ਕਨਫਿਗਰੇਸ਼ਨ 'ਤੇ ਨਿਰਭਰ; ਵਰਜ਼ਨਿੰਗ ਅਤੇ "ਡੌਕਸ-ਸਟਾਈਲ" ਨੈਵੀਗੇਸ਼ਨ ਲਈ ਵਾਧੂ ਕੰਮ ਲੱਗ ਸਕਦਾ ਹੈ।

ਇੱਕ ਵਰਤਮਾਨ ਨਿਯਮ: ਜੇ ਤੁਹਾਡੀ ਗਾਈਡ ਅਕਸਰ ਬਦਲੇਗੀ ਅਤੇ ਕਈ ਲੋਕ ਇਸ ਨੂੰ ਸੰਪਾਦਿਤ ਕਰਨਗੇ, ਤਾਂ docs ਪਲੇਟਫਾਰਮ ਜਾਂ CMS ਆਮ ਤੌਰ 'ਤੇ ਘੱਟ ਅੜਚਣ ਪੈਦਾ ਕਰਦਾ ਹੈ। ਜੇ ਤੁਸੀਂ ਇੱਕ ਹلਕਾ-ਫੁਲਕਾ, ਵੱਧ ਵਰਜ਼ਨਯੋਗ ਗਾਈਡ ਚਾਹੁੰਦੇ ਹੋ, ਤਾਂ SSG ਅਕਸਰ ਆਰਥਿਕ ਹੁੰਦਾ ਹੈ।

Koder.ai ਕਿੱਥੇ ਮਦਦ ਕਰ ਸਕਦਾ ਹੈ (ਬਿਨਾਂ ਤੁਹਾਡੇ ਡੌਕਸ ਨੂੰ ਪੂਰੇ ਸਾਫਟਵੇਅਰ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ ਬਦਲੇ)

ਜੇ ਤੁਸੀਂ ਰਵਾਇਤੀ "spec → build → iterate" ਸਾਈਕਲ ਤੋਂ ਤੇਜ਼ ਚਲਨਾ ਚਾਹੁੰਦੇ ਹੋ, ਤਾਂ vibe-coding ਪਲੇਟਫਾਰਮ ਜਿਵੇਂ Koder.ai ਇੰਟਰਐਕਟਿਵ ਹਿੱਸਿਆਂ ਲਈ ਵਾਜਿਬ ਵਿਕਲਪ ਹੋ ਸਕਦਾ ਹੈ। ਟੀਮਾਂ ਇਸਦੀ ਵਰਤੋਂ ਉਦਾਹਰਨ ਵਜੋਂ ਕਰਦੀਆਂ ਹਨ:

• ਇੱਕ print-friendly / downloadable migration checklist page ਸਧਾਰਨ ਪ੍ਰਗਤੀ ਟ੍ਰੈਕਿੰਗ ਨਾਲ
• ਇੱਕ decision helper questionnaire ਜੋ ਪਾਠਕਾਂ ਨੂੰ ਸਹੀ ਮਾਈਗ੍ਰੇਸ਼ਨ ਪਾਥ ਵੱਲ ਰਾਹ ਦਿਖਾਂਦਾ
• ਇੱਕ searchable docs UI ਜੋ ਤੁਹਾਡੀ ਚੁਣੀ ਹੋਈ website structure for documentation ਨੂੰ ਮੈਚ ਕਰਦਾ

Koder.ai ਚੈਟ ਰਾਹੀਂ ਵੈੱਬ ਐਪ ਜੈਨਰੇਟ ਕਰ ਸਕਦਾ ਹੈ (React ਫਰੰਟਏਂਡ ਅਤੇ ਜ਼ਰੂਰਤ ਹੋਣ ਤੇ Go + PostgreSQL ਬੈਕਏਂਡ), ਇਸ ਲਈ ਜਦੋਂ ਤੁਹਾਡੀ ਗਾਈਡ ਨੂੰ ਹਲਕਾ ਟੂਲ ਚਾਹੀਦਾ ਹੈ—ਤਾਂ ਬਿਨਾਂ ਲੰਬੇ ਕਸਟਮ ਵਿਕਾਸ ਪ੍ਰੋਸੈਸ ਦੇ ਤੁਸੀਂ ਤੇਜ਼ੀ ਨਾਲ ਪ੍ਰੋਟੋਟਾਈਪ ਕਰ ਸਕਦੇ ਹੋ। ਤੁਸੀਂ ਲੰਬੇ ਸਮੇਂ ਦੀ ਦੇਖਭਾਲ ਲਈ ਸੋурс ਕੋਡ ਵੀ ਐਕਸਪੋਰਟ ਕਰ ਸਕਦੇ ਹੋ।

ਹੋਸਟਿੰਗ ਅਤੇ ਡਿਪਲੌਇਮੈਂਟ ਬੁਨਿਆਦੀਆਂ

SSG ਲਈ, CDN/static hosting ਸਭ ਤੋਂ ਸਧਾਰਨ ਹੈ: ਤੁਸੀਂ pre-built ਫਾਈਲ ਪਬਲਿਸ਼ ਕਰਦੇ ਹੋ ਅਤੇ CDN ਉਨ੍ਹਾਂ ਨੂੰ ਤੇਜ਼ੀ ਨਾਲ ਸਰਵ ਕਰਦਾ ਹੈ। CMS ਜਾਂ ਡਾਇਨਾਮਿਕ ਡੌਕਸ ਟੂਲ ਲਈ, ਤੁਸੀਂ ਸਰਵਰ ਹੋਸਟਿੰਗ ਵਰਤੋਗੇ (managed hosting ਆਮ ਤੌਰ 'ਤੇ ਵਧੀਆ ਰਹਿੰਦੀ ਹੈ)।

ਡਿਪਲੌਇਮੈਂਟ ਪ੍ਰਕਿਰਿਆ ਭਵਿੱਖਵਾਣੀਯੋਗ ਰੱਖੋ: ਇੱਕ ਬਟਨ ਜਾਂ ਇੱਕ ਪਾਈਪਲਾਈਨ ਜੋ ਬਿਲਡ ਅਤੇ ਪ੍ਰਕਾਸ਼ਿਤ ਕਰਦਾ ਹੋਵੇ। ਜੇ ਸੰਭਵ ਹੋਵੇ, ਹਰ ਬਦਲਾਅ ਲਈ ਪ੍ਰੀਵਿਊ ਸੈਟ ਕਰੋ ਤਾਂ ਕਿ ਸਮੀਖਿਆਕਾਰ ਅਪਡੇਟ ਪਬਲਿਕ ਹੋਣ ਤੋਂ ਪਹਿਲਾਂ ਪੜ੍ਹ ਸਕਣ।

ਇੱਕ ਸਧਾਰਨ ਸਮੱਗਰੀ ਵਰਕਫਲੋ (Draft → Review → Publish)

ਤਿੰਨ ਪੜਾਵਾਂ ਪਰਿਭਾਸ਼ਿਤ ਕਰੋ ਅਤੇ ਓਹਨਾਂ ਨੂੰFollow ਕਰੋ:

1. Draft: ਲੇਖਕ ਇੱਕ ਪੰਨਾ ਲਿਖਦਾ/ਅਪਡੇਟ ਕਰਦਾ ਹੈ।
2. Review: ਇੱਕ ਮਾਈਗ੍ਰੇਸ਼ਨ SME ਸਹੀਤਾ ਜਾਂਚਦਾ ਹੈ; ਇੱਕ ਗੈਰ-ਟੈਕਨੀਕਲ ਸਮੀਖਿਆਕਾਰ ਸਪੱਸ਼ਟਤਾ ਜਾਂਚਦਾ ਹੈ।
3. Publish: ਅਪਡੇਟ ਰਿਲੀਜ਼ ਕਰੋ ਇੱਕ ਛੋਟੀ ਚੇਂਜਲੌਗ ਨੋਟ ਨਾਲ।

ਐਕਸੈਸ ਕੰਟਰੋਲ ਅਤੇ ਮਾਲਕੀਅਤ

ਜੇ ਕੁਝ ਸਮੱਗਰੀ ਗੋਪਨীয় ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ (ਅੰਦਰੂਨੀ ਰਨਬੁੱਕ, ਵੈਂਡਰ Credentials, ਜਾਂ ਗ੍ਰਾਹਕ-ਖਾਸ ਕਦਮ), ਤਾਂ ਸ਼ੁਰੂ ਵਿੱਚ ਹੀ ਐਕਸੈਸ ਕੰਟਰੋਲ ਯੋਜਨਾ ਬਣਾਓ: "ਪਬਲਿਕ" ਅਤੇ "ਪ੍ਰਾਈਵੇਟ" ਖੇਤਰਾਂ ਨੂੰ ਅਲੱਗ ਰੱਖੋ, ਜਾਂ ਦੂਜੀ ਅੰਦਰੂਨੀ ਸਾਈਟ ਪ੍ਰਕਾਸ਼ਤ ਕਰੋ।

ਅੰਤ ਵਿੱਚ, ਡੌਕਯੂਮੈਂਟੇਸ਼ਨ ਮਲਕੀਅਤ ਨਿਯੁਕਤ ਕਰੋ (ਇੱਕ ਪ੍ਰਾਇਮਰੀ ਮਾਲਕ + ਬੈਕਅੱਪ) ਅਤੇ ਇੱਕ ਅਪਡੇਟ ਕੈਡੈਂਸ ਦੇਵੋ (ਉਦਾਹਰਨ: ਮਾਈਗ੍ਰੇਸ਼ਨ ਦੌਰਾਨ ਮਹੀਨਾਵਾਰ, ਬਾਅਦ ਵਿੱਚ ਤਿਮਾਹੀ)। ਨਾਮ ਨਾਲ ਨਿਰਧਾਰਤ ਮਾਲਕਾਂ ਤੋਂ ਬਿਨਾਂ, ਡੌਕਸ ਜਲਦੀ ਪੁਰਾਣੇ ਹੋ ਜਾਂਦੇ ਹਨ।

SEO ਅਤੇ ਖੋਜਯੋਗਤਾ ਲਈ optimize ਕਰੋ

ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਲਈ SEO ਜਨਰਲ ਟ੍ਰੈਫਿਕ ਦੀ ਤਲਾਸ਼ ਨਹੀਂ ਹੈ—ਇਹ ਉਸ ਸਮੇਂ ਲੱਭਣਯੋਗ ਹੋਣਾ ਹੈ ਜਦੋਂ ਕੋਈ ਕਿਸੇ ਮੂਵ ਦੀ ਯੋਜਨਾ ਬਣਾਉਂਦਾ ਹੈ ਜਾਂ ਕਿਸੇ ਸਮੱਸਿਆ ਵਿੱਚ ਫੱਸ ਗਿਆ ਹੈ। "migration intent" ਖੋਜਾਂ ਲਈ ਨਿਸ਼ਾਨਾ ਬਣਾ ਕੇ ਹਰ ਪੰਨੇ ਨੂੰ ਇੱਕ ਸਪਸ਼ਟ ਕਦਮ ਦਾ ਜਵਾਬ ਬਣਾਓ।

migration-intent ਕੀਵਰਡ ਲਿਸਟ ਬਣਾਓ

ਇੱਕ ਸੂਚੀ ਬਣਾਓ ਜਿਹੜੀ ਸੋਰਸ, ਟਾਰਗਟ, ਅਤੇ ਕੰਮ ਸ਼ਾਮਿਲ ਕਰਦੀ ਹੋਵੇ। ਉਦਾਹਰਨ:

• “how to migrate from X to Y”
• “X to Y migration checklist”
• “export data from X” / “import into Y”
• “X to Y migration troubleshooting”

ਇਨ੍ਹਾਂ ਫਰੇਜ਼ਾਂ ਨੂੰ ਵਰਤ ਕੇ ਤੈਅ ਕਰੋ ਕਿ ਤੁਹਾਨੂੰ ਕਿਹੜੇ ਪੰਨੇ ਲੋੜੀਦੇ ਹਨ (ਪੂਰਵ-ਸ਼ਰਤ, ਕਦਮ-ਦਰ-ਕਦਮ ਟਾਸਕ, ਵੈਰੀਫਿਕੇਸ਼ਨ, ਰੋਲਬੈਕ, ਆਮ ਗਲਤੀਆਂ)।

ਸਿਰਲੇਖ ਅਤੇ ਹੇਡਿੰਗਜ਼ ਨੂੰ ਸਟੈਪ ਨਾਮ ਨਾਲ ਮਿਲਾਓ

ਲੋਕ ਖੋਜ ਨਤੀਜਿਆਂ ਨੂੰ ਸਕੈਨ ਕਰਦੇ ਹਨ। ਆਪਣੇ ਪੇਜ਼ ਦੇ ਸਿਰਲੇਖ (Title) ਅਤੇ H1 ਨੂੰ ਸਪਸ਼ਟ ਅਤੇ ਸਟੈਪ ਨਾਂ ਨਾਲ ਮਿਲਾਵੋ।

ਚੰਗਾ: “Step 3: Migrate Users from X to Y”

ਟਾਲੋ: “User Setup” (ਇਹ ਰੈਂਕ ਨਹੀਂ ਕਰੇਗਾ, ਅਤੇ ਨਿਰਾਸ਼ਾ ਪੈਦਾ ਕਰੇਗਾ)।

ਅੰਦਰੂਨੀ ਲਿੰਕਿੰਗ ਮਜ਼ਬੂਤ ਕਰੋ

ਅੰਦਰੂਨੀ ਲਿੰਕ ਪੜ੍ਹਨ ਵਾਲਿਆਂ ਨੂੰ ਰਾਹ ਦਿਖਾਉਂਦੇ ਹਨ ਅਤੇ ਸਿਰਚ ਇੰਜਣਾਂ ਨੂੰ ਸੰਰਚਨਾ ਸਮਝਣ ਵਿੱਚ ਮਦਦ ਕਰਦੇ ਹਨ।

ਲਿੰਕ ਕਰੋ:

• ਹਰ ਸਟੇਪ ਤੋਂ ਉਸਦੀ ਪੂਰਵ-ਸ਼ਰਤ ਤੇ ਅਗला ਸਟੇਪ
• ਸਟੇਪਾਂ ਤੋਂ ਸਬੰਧਤ ਟ੍ਰਬਲਸ਼ੂਟਿੰਗ ਪੰਨਾਂ (/troubleshooting/error-403) ਤੋਂ
• ਟ੍ਰਬਲਸ਼ੂਟਿੰਗ ਪੰਨਾਂ ਤੋਂ ਉਨ੍ਹਾਂ ਸਟੇਪਾਂ ਵੱਲ ਜੋ ਉਹ ਅਣਲੌਕ ਕਰਦੇ ਹਨ

ਲਿੰਕ ਪ੍ਰਭਾਵੀ ਅਤੇ ਉਨ੍ਹਾਂ ਥਾਵਾਂ ਦੇ ਨੇੜੇ ਰੱਖੋ ਜਿਵੇਂ ਕਿ ਪੜ੍ਹਨ ਵਾਲੇ ਨੂੰ ਲੋੜ ਹੋਵੇ।

URLs ਅਤੇ ਮੈਟਾਡੇਟਾ ਸਾਫ਼ ਰੱਖੋ

ਪਠਨਯੋਗ URLs ਵਰਤੋਂ ਜੋ ਸਟੈਪ ਨਾਮ ਨਾਲ ਮਿਲਦੇ ਹੋਣ, ਜਿਵੇਂ:

• /checklist
• /steps/migrate-users
• /troubleshooting/permission-errors

ਸੰਖੇਪ meta descriptions ਲਿਖੋ ਜੋ ਦੱਸਣ ਕਿ ਪੇਜ਼ ਕਿਸ ਲਈ ਹੈ, ਕੀ ਕਰਦਾ ਹੈ, ਅਤੇ ਨਤੀਜਾ (ਇੱਕ-ਵਾਕ ਵਾਅਦਾ)।

ਲੰਬੇ-ਦੌਰ ਦੀਆਂ ਖੋਜਾਂ ਲਈ glossary ਪੇਜ਼ ਜੋੜੋ

Glossary ਗੈਰ-ਟੈਕਨੀਕਲ ਪਾਠਕਾਂ ਦੀ ਮਦਦ ਕਰਦਾ ਹੈ ਅਤੇ "what is a migration token" ਜਾਂ "data mapping definition" ਵਰਗੀਆਂ ਖੋਜਾਂ ਨੂੰ ਕੈਚ ਕਰਦਾ ਹੈ। /glossary 'ਤੇ ਸਹੀ-ਸਮਝ ਪਰਿਭਾਸ਼ਾਵਾਂ ਰੱਖੋ ਅਤੇ ਸਟੇਪਾਂ ਤੋਂ ਲਿੰਕ ਕਰੋ।

ਵਰਤੋਂ ਮਾਪੋ, ਫੀਡਬੈਕ ਇਕੱਠਾ ਕਰੋ, ਅਤੇ ਸੁਧਾਰ ਕਰੋ

ਇੱਕ ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਉਸ ਵੇਲੇ ਲਾਭਦਾਇਕ ਰਹਿੰਦੀ ਹੈ ਜਦੋਂ ਤੁਸੀਂ ਦੇਖਦੇ ਹੋ ਕਿ ਲੋਕ ਕੀ ਕਰ ਰਹੇ ਹਨ, ਫਿਰ ਉਹਨਾਂ ਰੁਕਾਵਟਾਂ ਨੂੰ ਦੂਰ ਕਰਦੇ ਹੋ।

ਸਾਦਾ ਐਨਾਲਿਟਿਕਸ ਨਾਲ ਇੰਸਟਰੂਮੈਂਟ ਕਰੋ

ਇਕ ਛੋਟੀ ਘੱਟ-ਸੈਟਕਾਰੀਆਂ ਸਟਾਰਟ ਕਰੋ ਜੋ ਪੜ੍ਹਨ ਵਾਲੇ ਮਨਸ਼ਾ ਨਾਲ ਜੁੜੀਆਂ ਹੋਣ। ਕਾਰਜਕਾਰੀ ਸੰਕੇਤ:

• ਖੋਜ ਸ਼ਬਦ, ਪੇਜ਼ ਐਗਜ਼ਿਟ, ਅਤੇ ਚੈੱਕਲਿਸਟ ਡਾਊਨਲੋਡ ਲਈ ਇਵੈਂਟ
• ਉਹ ਸਟੈਪ ਜਿਨ੍ਹਾਂ 'ਤੇ ਡ੍ਰਾਪ-ਆਫ ਜਾਂ ਦੋਹਰਾਈ ਯਾਤਰਾ ਹੋਈ (ਅਕਸਰ ਨਿਰਦੇਸ਼ ਅਸਪਸ਼ਟ ਹੋਣ ਦੀ ਨਿਸ਼ਾਨੀ)

ਇਵੈਂਟਾਂ ਨੂੰ ਪੇਜ਼ਾਂ 'ਤੇ ਇਕਸਾਰ ਰੱਖੋ ਤਾਂ ਤੁਸੀਂ ਵੱਖ-ਵੱਖ ਭਾਗਾਂ ਦੀ ਤੁਲਨਾ ਕਰ ਸਕੋ ਅਤੇ ਰੁਝਾਨ ਪਛਾਣ ਸਕੋ (ਉਦਾਹਰਨ: "Data export" ਪੰਨੇ ਸਭ ਤੋਂ ਜ਼ਿਆਦਾ ਐਗਜ਼ਿਟ ਲੈਂਦੇ ਹਨ)।

ਫੀਡਬੈਕ ਨੂੰ ਆਸਾਨ ਬਣਾਓ (ਅਤੇ ਦਰਸਾਓ)

ਲੋਕ ਤਦ ਹੀ ਫੀਡਬੈਕ ਦਿੰਦੇ ਹਨ ਜਦੋਂ ਇਹ ਤੇਜ਼ ਅਤੇ ਸਵਾਗਤਯੋਗ ਹੋਵੇ।

• ਹਰ ਪੰਨੇ ਦੇ ਅਖੀਰ ਵਿੱਚ "Was this helpful?" ਪ੍ਰੌਮਪਟ ਸ਼ਾਮਿਲ ਕਰੋ, ਇੱਕ-ਕਲਿੱਕ Yes/No ਅਤੇ ਇਛਾਉਂਕ ਟਿੱਪਣੀ ਬਾਕਸ।
• ਵੱਡੀਆਂ ਨੋਟਾਂ ਲਈ ਇੱਕ ਹਲਕੀ ਫੀਡਬੈਕ ਫਾਰਮ (ਉਦਾਹਰਨ: "ਤੁਸੀਂ ਕੀ ਕਰਨ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰ ਰਹੇ ਸੀ?") ਫੁਟਰ ਜਾਂ /support ਪੇਜ਼ 'ਤੇ ਲਿੰਕ ਕਰੋ।
• ਤੇਜ਼ ਸੋਧਾਂ ਲਈ ਹਰ ਪੰਨੇ 'ਤੇ "report an issue" ਲਿੰਕ ਦਿਓ (ਪੇਜ਼ URL ਅਤੇ ਸਿਰਲੇਖ ਪਹਿਲਾਂ-ਭਰੇ ਹੋਣ) ਤਾਂ ਫਿਕਸ ਤੇਜ਼ ਹੋ ਸਕੇ।

ਸਿਗਨਲਾਂ ਨੂੰ ਸੁਧਾਰਾਂ ਵਿੱਚ ਬਦਲੋ

ਇੱਕ ਸਧਾਰਨ ਟ੍ਰਿਆਜ ਨੀਤੀ ਬਣਾਓ: ਜੋ ਕੁਝ ਪ੍ਰਗਟ ਰੂਪ ਵਿੱਚ ਪ੍ਰਗਟੀ ਰੁਕਾਵਟ ਪੈਦਾ ਕਰਦਾ ਹੈ (ਗਲਤ ਕਦਮ ਕ੍ਰਮ, ਗੁੰਮ ਪਮਿਸ਼ਨ, ਫੇਲ ਹੁੰਦੀਆਂ ਕਮਾਂਡ) ਪਹਿਲਾਂ ਠੀਕ ਕਰੋ। ਫਿਰ ਉਹ ਸੈਕਸ਼ਨਾਂ ਦੁਬਾਰਾ ਲਿਖੋ ਜਿੱਥੇ ਐਨਾਲਿਟਿਕਸ ਵਾਪਸੀ ਦਰਸਾਉਂਦੇ ਹਨ, ਅਤੇ ਵਧੇਰੇ ਉਦਾਹਰਨ ਜਾਂ "Common mistakes" ਛੋਟਾ ਸੈਕਸ਼ਨ ਜੋੜੋ।

ਸਮੀਖਿਆ ਕੈਡੈਂਸ ਸਥਾਪਤ ਕਰੋ

ਫੀਡਬੈਕ ਵਾਲਿਊਮ ਅਤੇ ਪ੍ਰੋਡਕਟ ਬਦਲਾਵਾਂ ਦੇ ਆਧਾਰ 'ਤੇ ਸਮੀਖਿਆ ਕੈਡੈਂਸ ਤੈਅ ਕਰੋ। ਇੱਕ ਬੇਸਲਾਈਨ ਵਜੋਂ, ਉੱਚ-ਟਰੈਫਿਕ ਪੰਨਿਆਂ ਦੀ ਮਹੀਨਾਵਾਰ ਸਮੀਖਿਆ ਅਤੇ ਪੂਰੇ ਡੌਕਸ ਸਾਈਟ ਦੀ ਤਿਮਾਹੀ ਸਮੀਖਿਆ ਕਰੋ। ਰਿਲੀਜ਼ ਨੋਟਸ ਨਾਲ ਸਮੀਖਿਆ ਜੋੜਨ ਨਾਲ ਗਾਈਡ ਉਤਪਾਦ ਵਿੱਚ ਹੋ ਰਹੀਆਂ ਬਦਲਾਵਾਂ ਨਾਲ ਸੰਗਤ ਰਹੇਗੀ।

ਵਰਜ਼ਨਿੰਗ, ਅਪਡੇਟ, ਅਤੇ ਲੰਬੇ ਸਮੇਂ ਦੀ ਮਰੰਮਤ ਯੋਜਨਾ ਬਣਾਓ

ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਤਦ ਹੀ ਲਾਭਦਾਇਕ ਰਹਿੰਦੀ ਹੈ ਜਦੋਂ ਇਹ ਉਹ ਉਤਪਾਦ ਜੋ ਲੋਕ ਮਾਈਗ੍ਰੇਟ ਕਰ ਰਹੇ ਹਨ, ਨਾਲ ਮੇਲ ਖਾਂਦੀ ਰਹੇ। ਵਰਜ਼ਨਿੰਗ ਅਤੇ ਨਿਬੜੀ-ਸੰਭਾਲ "ਬਾਅਦ" ਵੱਲ ਮੋਦੀ ਜਾਣ ਵਾਲੇ ਕੰਮ ਨਹੀਂ—ਇਹ ਉਹ ਹਨ ਜੋ ਗਾਈਡ ਨੂੰ ਭਰੋਸੇਯੋਗ ਰੱਖਦੇ ਹਨ ਅਤੇ ਸਟੇਕਹੋਲਡਰਾਂ ਵੱਲੋਂ ਸਾਂਝੇ ਕੀਤੇ ਪੰਨਿਆਂ ਕਰਕੇ ਬਣੌਕੀਆਂ ਘਟਾਉਂਦੇ ਹਨ।

ਵਰਜ਼ਨ ਸਪਸ਼ਟਤਾ ਨੂੰ ਅਟੱਲ ਬਣਾਓ

ਜੇ ਤੁਹਾਡੇ ਸਾਫਟਵੇਅਰ ਦੇ ਕਈ ਸਮਰਥਿਤ ਵਰਜ਼ਨ ਹਨ, ਤਾਂ ਹਰ ਸੰਬੰਧਤ ਪੰਨੇ 'ਤੇ ਵਰਜ਼ਨ ਸਿਲੈਕਟਰ ਜਾਂ ਬਹੁਤ ਸਪਸ਼ਟ ਵਰਜ਼ਨ ਲੇਬਲ ਸ਼ਾਮਿਲ ਕਰੋ (ਉਦਾਹਰਨ: "Source: v3.2 → Target: v4.0"). ਇਹ ਜਾਣਕਾਰੀ ਇੰਟਰੋ ਪੈਰਾ ਵਿੱਚ ਛੁਪਾਉਣ ਦੀ ਬਜਾਏ ਸਿਰਲੇਖ ਨੇੜੇ ਪ੍ਰਮੁੱਖ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ—ਕਿਉਂਕਿ ਪੜ੍ਹਨ ਵਾਲੇ ਆਮ ਤੌਰ 'ਤੇ ਖੋਜ ਤੋਂ ਡੈੱਪ ਲੇਵਲ ਪੰਨਿਆਂ 'ਤੇ ਲੈਂਡ ਕਰਦੇ ਹਨ।

ਜੇ ਤੁਸੀਂ ਸਿਲੈਕਟਰ ਨਹੀਂ ਲਗਾ ਸਕਦੇ, ਤਾਂ ਸਿਰਲੇਖ ਨੇੜੇ ਅਤੇ ਕਾਲਆਉਟ ਨੋਟਾਂ ਵਿੱਚ ਸਪਸ਼ਟ ਲੇਬਲ ਵਰਤੋ ਜਿਵੇਂ "Applies to v4.0+"। ਲਗਾਤਾਰਤਾ ਫੈਂਸੀ UI ਨਾਲੋਂ ਵੱਧ ਜ਼ਰੂਰੀ ਹੈ।

ਰਿਲੀਜ਼ਾਂ ਨਾਲ ਜੁੜੀ ਅਪਡੇਟ ਨੀਤੀ ਸਥਾਪਤ ਕਰੋ

ਅਪਡੇਟ ਕਿਵੇਂ ਹੁੰਦੇ ਹਨ ਅਤੇ ਕੌਣ ਜਿੰਮੇਵਾਰ ਹੈ, ਇਹ ਪਰਿਭਾਸ਼ਿਤ ਕਰੋ ਅਤੇ ਬਦਲਾਵਾਂ ਨੂੰ ਉਤਪਾਦ ਰਿਲੀਜ਼ਾਂ ਅਤੇ ਮਾਈਗ੍ਰੇਸ਼ਨ ਟੂਲਿੰਗ ਅੱਪਡੇਟ ਨਾਲ ਜੋੜੋ। "ਹਫਤਾਵਾਰ ਅਪਡੇਟ" ਵਰਗੇ ਵਾਅਦੇ ਕਰਨ ਤੋਂ ਬਚੋ; ਬਜਾਏ ਇੱਕ ਭਰੋਸੇਯੋਗ ਨੀਤੀ ਦਿਓ, ਉਦਾਹਰਨ:

• ਮੈਨਜਰਡ ਰੂਪ ਵਿੱਚ ਮੈਜਰ/ਮਾਈਨਰ ਰਿਲੀਜ਼ਾਂ ਦੇ ਨਾਲ ਅਪਡੇਟ
• ਜਦੋਂ ਮਾਈਗ੍ਰੇਸ਼ਨ ਟੂਲਿੰਗ ਬਦਲੇ ਜਾਂ ਕੋਈ ਸੰਘੀ ਸਮੱਸਿਆ ਮਿਲੇ ਤਦ ਪੈਚ

ਇਹ ਨੀਤੀ ਇੱਕ ਛੋਟੇ "About this guide" ਪੰਨੇ (/migration-guide/about) 'ਤੇ ਪ੍ਰਕਾਸ਼ਿਤ ਕਰੋ ਤਾਂ ਉਮੀਦਾਂ ਸਪਸ਼ਟ ਰਹਿਣ।

ਬਦਲਾਅ ਟ੍ਰੈਕ ਕਰੋ ਅਤੇ ਪੁਰਾਣੇ ਲਿੰਕਾਂ ਦੀ ਰੱਖਿਆ ਕਰੋ

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

ਜਦੋਂ ਕਾਰਜਵਿਧੀਆਂ ਪੁਰਾਣੀਆਂ ਹੋ ਜਾਂਦੀਆਂ ਹਨ, ਉਨ੍ਹਾਂ ਨੂੰ ਮਿਟਾਉਣ ਦੇ ਬਦਲੇ ਆਰਕਾਈਵ ਕਰੋ। ਉਨ੍ਹਾਂ 'ਤੇ "Archived" ਲੇਬਲ ਲਗਾਓ ਅਤੇ ਦੱਸੋ ਕੀ ਬਦਲਾਇਆ ਗਿਆ। ਸਭ ਤੋਂ ਮਹੱਤਵਪੂਰਨ, ਪੁਰਾਣੇ URLs ਤੋਂ ਨਵੇਂ ਸਥਾਨਾਂ ਲਈ ਰੀਡਾਇਰੈਕਟ ਰੱਖੋ ਤਾਂ ਕਿ ਟਿਕਟਾਂ, ਈਮੇਲਾਂ, ਜਾਂ ਬੁੱਕਮਾਰਕਾਂ ਵਿਚ ਸਾਂਝੇ ਕੀਤੇ ਪੰਨੇ ਟੁੱਟਣ ਨਾ ਪਾਣ।

ਹਲਕੀ-ਫੁਲਕੀ QA ਜਾਂਚ ਜੋੜੋ

ਪਬਲਿਸ਼ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਸਧਾਰਨ ਸਮੱਗਰੀ QA ਸੈੱਟ ਕਰੋ:

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

ਇਹ ਜਾਂਚਾਂ ਨਿਰੰਤਰ ਬਗ਼ੈਰ ਅਨੁਸ਼ਾਸਨ ਦੇ ਬਦਲਾਅ ਰੋਕਣਗੀਆਂ ਅਤੇ ਲੰਬੇ ਸਮੇਂ ਦੀ ਸਾਂਭ ਸੰਭਾਲ ਯੋਗ ਬਣਾਉਂਦੀਆਂ ਹਨ।

ਪਹੁੰਚਯੋਗਤਾ (Accessibility), ਸੁਰੱਖਿਆ, ਅਤੇ ਕੰਪਲਾਇੰਸ ਬੁਨਿਆਦੀ ਬਿੰਦੂ ਕਵਰ ਕਰੋ

ਮਾਈਗ੍ਰੇਸ਼ਨ ਗਾਈਡ ਬਾਰ-ਬਾਰ ਦਬਾਅ ਹੇਠਾਂ ਵਰਤੀ ਜਾਂਦੀ ਹੈ: ਕਟਓਵਰ ਦੌਰਾਨ, ਘਟਨਾ ਸੰਭਾਲ, ਅਤੇ ਰਾਤ ਦੇ ਵੇਲੇ ਤਸਦੀਕ। ਇਹੇ ਸਮੇਂ ਹਨ ਜਦੋਂ ਛੋਟੀਆਂ "ਬੁਨਿਆਦੀ" ਚੀਜ਼ਾਂ (ਪਹੁੰਚਯੋਗਤਾ, ਸੁਰੱਖਿਆ, ਕੰਪਲਾਇੰਸ) ਅਸਲ ਰੁਕਾਵਟਾਂ ਨੂੰ ਰੋਕਦੇ ਹਨ—ਜਿਵੇਂ ਕਿ ਕੋਈ ਸਾਈਟ ਨੂੰ ਕੀਬੋਰਡ ਨਾਲ ਨਹੀ ਚਲਾ ਸਕਦਾ, ਜਾਂ ਇੱਕ ਉਦਾਹਰਣ ਵਿੱਚ ਗਲਤ ਤਰੀਕੇ ਦੀ ਕ੍ਰੈਡੇਨਸ਼ਲ ਪੈਟਰਨ ਦਿੱਤੀ ਹੋਵੇ।

ਪਹੁੰਚਯੋਗਤਾ: ਹਰ ਕਿਸੇ ਲਈ ਵਰਤਣਯੋਗ ਬਣਾਓ

ਹਰ ਪੰਨੇ ਟੈਮਪਲੇਟ 'ਤੇ ਲਾਗੂ ਹੋਣ ਵਾਲੀਆਂ ਮੂਢੀ ਨੀਤੀਆਂ ਨਾਲ ਸ਼ੁਰੂ ਕਰੋ:

• ਸਪਸ਼ਟ ਹੈਡਿੰਗ ਹਾਇਰਾਰਕੀ (H2 ਮੁੱਖ ਸੈਕਸ਼ਨ ਲਈ, H3 ਉਪ-ਸੈਕਸ਼ਨ ਲਈ) ਤਾਂ ਕਿ ਸਕ੍ਰੀਨ ਰੀਡਰ ਪੰਨਾ ਬਣਤਰ ਨੂੰ ਸਕੈਨ ਕਰ ਸਕੇ।
• ਲਿਖਤ, ਲਿੰਕ ਅਤੇ ਕਾਲਆਉਟ ਲਈ ਕਾਫੀ ਰੰਗ ਕਾਨਟਰਾਸਟ ਤਾਂ ਜੋ "ਚੇਤਾਵਨੀ" ਬਲਾਕ ਵੀ ਪੜ੍ਹੇ ਜਾ ਸਕੇ।
• ਡਾਇਗ੍ਰਾਮਾਂ ਅਤੇ ਸਕ੍ਰੀਨਸ਼ਾਟਾਂ ਲਈ ਮੀਨਿੰਗਫੁਲ alt ਟੈਕਸਟ ਜੋੜੋ ("Network flow showing source → staging → target") ਨਾ ਕਿ "image"।
• ਕੀਬੋਰਡ ਨੈਵੀਗੇਸ਼ਨ ਟੈਸਟ ਕਰੋ: ਯੂਜ਼ਰ ਨੈਵੀਗੇਸ਼ਨ, ਕੰਟੈਂਟ 'ਤੇ ਸਕਿੱਪ ਕਰਨ, ਮੇਨੂ ਖੋਲ੍ਹਣ, ਅਤੇ ਖੋਜ਼ ਵਰਤੋਂ ਬਿਨਾਂ ਮਾਊਸ ਦੇ ਕਰਨ ਯੋਗ ਹੋਣ।

ਜੇ ਤੁਸੀਂ ਡਾਇਗ੍ਰਾਮ ਅਜਿਹਾ ਪ੍ਰਕਾਸ਼ਤ ਕਰਦੇ ਹੋ ਜਿਸ ਵਿੱਚ ਮੁੱਖ ਜਾਣਕਾਰੀ ਹੈ, ਤਾਂ ਉਹਨਾਂ ਦੇ ਹੇਠਾਂ ਛੋਟਾ ਟੈਕਸਟ ਖੁਲਾਸਾ ਦਿਓ। ਇਹ ਪਹੁੰਚਯੋਗਤਾ ਵਿੱਚ ਮਦਦ ਕਰਦਾ ਹੈ ਅਤੇ ਨਾਨ-ਟੈਕਨੀਕਲ ਪਾਠਕਾਂ ਲਈ ਤੇਜ਼ੀ ਨਾਲ ਸਰੋਤ ਕਰਨਯੋਗ ਬਣਾਉਂਦਾ ਹੈ।

ਸੁਰੱਖਿਆ: ਉਦਾਹਰਣ ਸੁਰੱਖਿਅਤ ਡਿਫਾਲਟ ਹੋਣ

ਮਾਈਗ੍ਰੇਸ਼ਨ ਡੌਕਸ ਅਕਸਰ config, CLI ਕਮਾਂਡ, ਅਤੇ ਨਮੂਨਾ ਡੇਟਾ ਸ਼ਾਮਿਲ ਕਰਦੀਆਂ ਹਨ। ਸਭ ਉਦਾਹਰਣਾਂ ਨੂੰ ਏਸ ਤਰ੍ਹਾਂ ਮੰਨੋ ਕਿ ਉਹ ਪ੍ਰੋਡਕਸ਼ਨ ਵਿੱਚ ਨਕਲ ਕੀਤੇ ਜਾ ਸਕਣ:

• ਕਦੇ ਵੀ ਰੀਅਲ ਗਾਹਕ ਨਾਂ, ਅੰਦਰੂਨੀ ਹੋਸਟਨੇਮ, IPs, API keys, ਟੋਕਨ, ਜਾਂ ਲੋਗ ਨਕਲ ਸ਼ਾਮਿਲ ਨਾ ਕਰੋ।
• ਹਕੀਕਤੀ ਸਥਾਨਾਂ ਤੇ placeholders ਅਤੇ ਸਪਸ਼ਟ ਰੇਡੈਕਸ਼ਨ ਵਰਤੋਂ (ਜਿਵੇਂ REDACTED_TOKEN, example.company, 10.0.0.0/24)।

ਜਿੱਥੇ ਕਦਮ ਖਤਰਾ ਪੈਦਾ ਕਰ ਸਕਦਾ ਹੈ, ਉਥੇ "security notes" ਜੋੜੋ: ਟੂਲ ਚਲਾਉਣ ਲਈ ਲੋੜੀਂਦੇ ਪਰਮਿਸ਼ਨ, ਸੁਰੱਖਿਅਤ ਕ੍ਰੈਡੇਨਸ਼ਲ ਹੈਂਡਲਿੰਗ (env vars, secret managers), ਅਤੇ ਚਲਾਉਣ ਬਾਅਦ ਑ਡਿਟ ਲੌਗਾਂ ਵਿੱਚ ਕੀ ਚੈੱਕ ਕਰਨਾ ਹੈ।

ਕੰਪਲਾਇੰਸ: ਉਹ ਨਿਯਮ ਜਿਹੜੇ ਯੋਜਨਾ ਬਦਲਦੇ ਹਨ, ਉਨ੍ਹਾਂ ਦਾ ਉਲੇਖ ਕਰੋ

ਜੇ ਤੁਹਾਡੇ ਪਾਠਕ ਨਿਯਮਤ ਵਾਤਾਵਰਣਾਂ ਵਿੱਚ ਕੰਮ ਕਰਦੇ ਹਨ, ਤਾਂ ਸਬੰਧਤ ਪੰਨਾਂ 'ਤੇ ਸੰਞੇਪ ਕੰਪਲਾਇੰਸ ਨੋਟ ਸ਼ਾਮਿਲ ਕਰੋ:

• ਮਾਈਗ੍ਰੇਸ਼ਨ ਅਤੇ ਰੋਲਬੈਕ ਦੌਰਾਨ ਡੇਟਾ ਰੀਟੇਨਸ਼ਨ ਅਤੇ ਮਿਟਾਉਣ ਦੀਆਂ ਲੋੜਾਂ
• ਖੇਤਰੀ ਸਟੋਰੇਜ ਅਤੇ ਪਰ-ਬਾਰਡਰ ਟ੍ਰਾਂਸਫਰ ਸੀਮਾਵਾਂ
• ਸਬੂਤ ਦੀਆਂ ਲੋੜਾਂ (ਕਿਸ ਸਕ੍ਰੀਨਸ਼ਾਟ/ਲੋਗ ਨੂੰ ਕਿੰਨੀ ਦੇਖਭਾਲ ਕਰਨੀ ਹੈ)

ਸਖ਼ਤ ਅੰਦਰੂਨੀ ਪ੍ਰਕਿਰਿਆਵਾਂ ਦਾ ਸਮਰਥਨ ਕਰੋ

ਕੁਝ ਟੀਮਾਂ ਨੂੰ ਚੇਂਜ ਰਿਕਵੇਸਟ ਨਾਲ ਯੋਜਨਾਵਾਂ ਜੁੜੀਆਂ ਹੋਣੀਆਂ ਪੈਂਦੀਆਂ ਹਨ। ਪ੍ਰਿੰਟੇਬਲ/ਐਕਸਪੋਰਟ ਯੂਜੇਬਲ ਫਾਰਮੈਟ (PDF, ਪ੍ਰਿੰਟ-ਫ੍ਰੈਂਡਲੀ ਪੰਨੇ, ਜਾਂ "download checklist" ਦ੍ਰਿਸ਼) ਦੇ ਵਿਕਲਪ ਦਿਓ। ਚੈੱਕਲਿਸਟਾਂ ਲਈ ਇੱਕ समर्पਿਤ /migration-checklist ਪੇਜ਼ ਵਿਚਾਰ ਕਰੋ ਜੋ ਸਾਫ਼ ਪ੍ਰਿੰਟ ਹੋਵੇ ਅਤੇ ਇੰਟਰਐਕਟਿਵ-ਓਨਲੀ UI 'ਤੇ ਨਿਰਭਰ ਨਾ ਹੋਵੇ।