Technical Articles
F5 SMEs share good practice.
cancel
Showing results for 
Search instead for 
Did you mean: 
JRahm
Community Manager
Community Manager

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.

Comments
Satvayan_Kosok
Legacy Employee
Legacy Employee

all google link to devcentral are broken

action_-
Altostratus
Altostratus

All my wiki bookmarks 😢

Juraj
Cirrus
Cirrus

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.

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
F5 Employee
F5 Employee

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

JRahm
Community Manager
Community Manager

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
Community Manager
Community Manager

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
Community Manager
Community Manager

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
Community Manager
Community Manager

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

Juraj
Cirrus
Cirrus

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

Syntax highlight would make it readable.

PeteWhite
F5 Employee
F5 Employee
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
Community Manager
Community Manager

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
Altocumulus
Altocumulus

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?

 

0691T000006B36cQAC.jpg

JRahm
Community Manager
Community Manager

@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
Cirrostratus
Cirrostratus

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:

 

JRahm
Community Manager
Community Manager

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
Cirrostratus
Cirrostratus

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
Altostratus
Altostratus

HI Jason ,

 

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

 

Thanks!

Terje_Gravvold
Nimbostratus
Nimbostratus

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
Community Manager
Community Manager

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
Nimbostratus
Nimbostratus

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
Community Manager
Community Manager

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
Nimbostratus
Nimbostratus

 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
Community Manager
Community Manager

@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
Nimbostratus
Nimbostratus

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

Version history
Last update:
‎09-May-2019 01:23
Updated by:
Contributors