DevCentral Relaunch Part Deux: Wiki Wiki...What?

[JRahm]

Good people of the DevCentral community, greetings! On the heels of Chase's relaunch post last week, now that we are live on the new platform, what you have come to know and love as the DevCentral Wiki no longer exists in its current format.

Wait…What?

Yes, you read that correctly. The wiki is no more. When we were scoping the platform transition effort, we wanted to look at not just what the DevCentral audience needs, but what makes the most sense from a documentation perspective. Given that most of the API documentation in the wiki is more along the lines of product reference than insight or tutorial, it made sense to transition that type of content away from the pages of DevCentral where it can (eventually) be more accurately and continually updated by the tech docs team rather than by the DevCentral team. For now, the new home for the API documentation is on Clouddocs at https://clouddocs.f5.com/api/.

The astute observers among you who engage often in the wiki have likely noticed that some of the API namespaces have already transitioned away to CloudDocs (here’s looking at you, iApps LX and BIG-IQ!) The following wiki namespaces have joined iApps LX and BIG-IQ on CloudDocs:

• iApps
• iHealth
• iControl REST
• iControl SOAP
• iRules
• iRules LX
• tmsh

The remaining namespaces were decommissioned when the new site launched. However, we have identified content from those namespaces that get consistent traffic. Those pages will be converted and released as articles at some point in the near future. If something specific is of interest, please drop a comment below and I’ll prioritize it.

Embedded Links and Bookmarks and Search Queries, Oh My!

Relaunch is the beginning of a new journey, not a destination. We just landed in Kansas and are standing at the inception of the yellow brick road. As such, there are some things outside of our immediate control that might make things a challenge at first. Namely, finding your favorite API documentation by way of embedded links, bookmarks, and search. We have some limitations we’re working through, so outside of the individual API landing pages, your embedded links and bookmarks are unlikely to land properly. Also, search will take some time to rectify itself, but If you navigate directly to https://clouddocs.f5.com/api/, you should be able to quickly click through to your content.

UPDATE - one of our former MVPs Michael Jenkins wrote a tampermonkey script to ease the pain with wiki links. Load this up in your tampermonkey browser extension and it'll rewrite the URL on the click event and send you over to clouddocs.

The Sky is Not Falling

I can hear the collective groan from all you power users. I get it. Your experience on DevCentral matters to me. And because I am as much a client as I am an owner of the DevCentral community, it is imperative to preserve what we have and make it available in the event that something currently in the wiki is critical to you but not necessarily to the community at large. If this is you, the wiki as it exists today is available as a download that you can keep on your system for reference. It will not be updated going forward, but it contains most of what was in the wiki at cutover earlier today.

To Infinity, And Beyond!

The pause button on our platform innovation has been activated for quite some time here at DevCentral. We’re excited to move forward, and we hope you enjoy the new platform and assist us in navigating the bumps common with all launch activities.

[Satvayan_Kosok]

all google link to devcentral are broken

[action_-]

All my wiki bookmarks 😢

[Juraj]

Please, add syntax highlighting to all your code examples on Clouddocs; it's really terrible to follow the examples when the code gets mangled together with comments without any syntax highlight. Thank you.

[jaikumar_f5]

Yesterday I was trying to explore on an Irule syntax. So I googled this query"F5 + [SSL::verify_result]" and the top result I got is that of the WIKI (As usual I expected this). But upon click I noticed that it all got moved 😐 I dont see any global notifications in there which could atleast point me to the clouddoc. Would this be fixed at some point.

[PeteWhite]

I see that codeshare is not working. If you search, the link takes you to articles, not codeshare. Is codeshare still available?

[JRahm]

Hi Pete, codeshare uses the same module as articles, so the list views for articles and codeshare are different, but the detailed view seems the same. It shouldn't impact functionality.

[JRahm]

Hi s.kosok and jaikumar_f5, google results should work themselves out over the next week or so. All iRules content is here: https://clouddocs.f5.com/api/.

[JRahm]

HI Juraj, do you have an example from clouddocs I can reference? The conversion script put everything in code blocks, but there is no syntax highlight within codeblocks planned at this time. If there are examples where code is outside of code blocks, let me know and I'll work to correct those. Thanks.

[JRahm]

Hi action_- yeah...bookmarks will be problematic. Most of those might have to be rebuilt.

[Juraj]

Hi  , yeah I was referring to a clouddocs code in the codeblocks. For example:

• https://clouddocs.f5.com/api/irules/ACCESS__policy.html

Syntax highlight would make it readable.

[PeteWhite]

Hi Jason, Regarding the codeshare, for example if you look for my iCR python module you can search for it, it shows a link to it but when I click on that link it takes me to the main articles page, not to codeshare or indeed the page I wanted. Needs a link adding between the codeshare and the article maybe? Regards Peter White

[JRahm]

HI @Pete, yeah there have been a couple reports of that, looking into it

Hi @blackiyto, that has been requested by multiple people. Not an immediate priority, but I'll look into that as well.

[Stan_Ward]

Kudos for the Wiki Download; that would have been useful even before the move. However, I'm getting lots of "The parameter is incorrect" errors unpacking it. Here's a typical one. Retries allow most to continue, but some I have to skip (like the one below). I would assume that those that are skipped would be missing content, but they don't look like valid file names. Any suggestions?

[JRahm]

@stan, there were some scraping issues on the wiki source. Non windows systems didn't have a problem loading the files, but yeah, I noticed these on win10 as well. I just skipped all. But YMMV.

[hooleylist]

Also, links from the Wiki pages on Clouddocs refer back to the old DC wiki pages or Codeshare examples which 404 as the content is on Clouddocs. In Juraj's page:

https://clouddocs.f5.com/api/irules/ACCESS__policy.html

there is a link to an iRule which 404s: https://devcentral.f5.com/wiki/iRules.Google-Authenticator-Token-Verification-iRule-For-APM.ashx

Sample Code:

• Google Authenticator Token Verification iRule For APM - This iRule adds token authentication capabilities for Google Authenticator to APM.

[JRahm]

Hi @hoolio, yeah, all the sample code links are broken. I ported the wiki over to clouddocs "as is" so it would still be available after the move for reference as this information isn't available anywhere else. I am adding some language to pages with sample code (which is easily scripted) to copy the text and search for that on DC.

[TimRiker]

This is getting to the level of silly. Google won't find the docs, I get prompted to login every time I visit, the search interface is awful, the comments are all hidden by default so you only see some random old post.

This site "upgrade" is about as big a "downgrade" as I can imagine.

[Sukesh123456]

HI Jason ,

Would you be able to help me with documentation for migrating netscalar configuration to F5 ?

Thanks!

[Terje_Gravvold]

Hi,

When creating a user account on the new DevCentral you get an option to merge your old profile with the new one. In my case this procedure failed, is it possible to merge the old profile after the new one is created?

[LiefZimmerman]

Terje,

I see that your account appears created and merged? (it takes a few minutes to go out and try to get everything) If there is something you still think is amiss with that process shoot us a note using the Contact Us form below.

[dllawson68]

Where is the appropriate place to log issues with the migration. I submitted Method information missing from SOAP API reference DevCentral a couple of weeks ago and have had no response yet. Is there an offline version of the SOAP API reference I can use until this is resolved?

[JRahm]

There is a download mentioned in the article above of the original wiki contents. I'll take a look at that particular wiki entry.

[dllawson68]

 well it isn't easy to look at but it at least appears to have all of the information I need. Thanks for the workaround.

[JRahm]

@dllawson68, I'm making updates for the iControl section on clouddocs this week, if there's anything else you know is askew let me know.

[dllawson68]

Hi  . It's been a while since I revisited this as I don't use the SOAP API much these days but I'm still seeing the Method information missing in the online API reference. I apparently lost the local copy I had downloaded in a laptop upgrade and the link above isn't working for me anymore. Is there another location I can still download the full reference from? What I specifically need right now is the method information from https://clouddocs.f5.com/api/icontrol-soap/LocalLB__VirtualAddressV2.html

Thanks